Método ISynchronize::Wait (objidl.h)

  • Artigo

Aguarda que o objeto de sincronização seja sinalizado ou que um período de tempo limite especificado seja decorrido, o que ocorrer primeiro.

Sintaxe

HRESULT Wait(
  [in] DWORD dwFlags,
  [in] DWORD dwMilliseconds
);

Parâmetros

[in] dwFlags

As opções de espera. Os valores possíveis são obtidos da enumeração COWAIT_FLAGS .

[in] dwMilliseconds

O tempo que essa chamada aguardará antes de retornar, em milissegundos. Se esse parâmetro for INFINITE, o chamador aguardará até que o objeto de sincronização seja sinalizado, independentemente do tempo necessário. Se esse parâmetro for 0, o método retornará imediatamente.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY e E_FAIL, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 O objeto de sincronização foi sinalizado.
RPC_S_CALLPENDING
 O período de tempo limite decorrido antes do objeto de sincronização ser sinalizado.
RPC_E_NO_SYNC
 Não há nenhum objeto de sincronização para aguardar.

Comentários

Se o chamador estiver aguardando em um apartamento de thread único, Wait entrará no loop modal COM. Se o chamador estiver aguardando em um apartamento multithread, o chamador será bloqueado até que Wait retorne.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h (inclua ObjIdl.h)

Confira também

CoWaitForMultipleHandles

ISynchronize