CMultiLock::Lock

Bloqueio de DWORD (DWORD dwTimeOut = infinito, BOOL bWaitForAll = TRUE, DWORD dwWakeMask = 0);

Valor de retorno

Se Lock falhar, ele retur&nsnbsp; – 1. Se bem-sucedido, ele retorna um dos seguintes valores:

• E&ntre WAIT_OBJECT_0 e WAIT_OBJECT_0 + (número de objectsnbsp, -1)

  Se bWaitForAll for verdadeiro, todos os objetos são si&nalizados (disponíveis). Se bWaitForAll for falsa, o retorno valuenbsp; – WAIT_OBJECT_0 é o índice da matriz de objetos do objeto que está sinalizado (disponíveis).

• WAIT_OBJECT_0 + (número de objetos)

  Um evento especificado na dwWakeMask está disponível na fila de entrada do segmento.

• Entre WAIT_ABA&NDONED_0 e WAIT_ABANDONED_0 + (número de objectsnbsp, -1)

  Se bWaitForAll for verdadeiro, todos os objetos são sinalizados e pelo menos um dos objetos é um objeto mutex abandonadas. Se bWaitForAll for falsa, o retorno valuenbsp; – WAIT_ABA&NDONED_0 é o índice da matriz de objetos do objeto mutex abandonadas que atendidas de espera.

• WAIT_TIMEOUT

  O intervalo de tempo limite especificado em dwTimeOut expirado sem o êxito de espera.

Parâmetros

dwTimeOut

Especifica a quantidade de tempo de espera para o objeto sincronização esteja disponível (sinalizado). Se INFINITE, Lock aguardará até que o objeto é sinalizado antes de retornar.

bWaitForAll

Especifica se Tudo objetos aguardados devem tornam-se signaled ao mesmo tempo antes de retornar. Se FALSE, Lock retornará quando qualquer um dos objetos aguardado é sinalizado.

dwWakeMask

Especifica outras condições que podem anular o tempo de espera. Para obter uma lista completa das opções disponíveis para este parâmetro, consulte MsgWaitForMultipleObjects na Referência do programador do Win32.

Observações

Chame esta função para obter acessar a um ou mais dos recursos controlados por objetos de sincronização fornecidos para o Construtor de CMultiLock . Se bWaitForAll for verdadeiro, Lock retornará com êxito assim que todos os objetos de sincronização tornam-se signaled simultaneamente. Se bWaitForAll for FALSE, Lock retornará assim que um ou mais dos objetos de sincronização torna-se signaled.

Se Bloquear não é capaz de retornar imediatamente, ele vai esperar para não mais do que o número de milissegundos especificado no parâmetro dwTimeOut antes de retornar. Se dwTimeOut é infinito, Lock não retornará até que o acesso a um objeto é adquirido ou uma condição especificada na dwWakeMask foi atendida. Caso contrário, se o bloqueio foi capaz de adquirir um objeto de sincronização, ele retornará com êxito; caso contrário, ela retornará falha.

Visão geral de CMultiLock |  Membros de classe | Gráfico de hierarquia