Compartilhar via

Método ISynchronizeContainer::WaitMultiple (objidlbase.h)

  • Artigo

Aguarda que qualquer objeto de sincronização no contêiner seja sinalizado ou por um período de tempo limite especificado decorrido, o que ocorrer primeiro.

Sintaxe

HRESULT WaitMultiple(
  [in]  DWORD        dwFlags,
  [in]  DWORD        dwTimeOut,
  [out] ISynchronize **ppSync
);

Parâmetros

[in] dwFlags

As opções de espera. Os valores possíveis são obtidos da enumeração COWAIT_FLAGS . COWAIT_WAITALL não é uma configuração válida para esse método.

[in] dwTimeOut

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

[out] ppSync

Um ponteiro para um ponteiro de interface ISynchronize no objeto de sincronização que foi sinalizado. Esse parâmetro não pode ser NULL.

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_E_TIMEOUT
 O período de tempo limite decorrido antes do objeto de sincronização ser sinalizado.
RPC_E_NO_SYNC
 Não há objetos de sincronização no contêiner.

Comentários

Se o chamador estiver aguardando em um apartamento de thread único, WaitMultiple entrará no loop modal COM. Se o chamador estiver aguardando em um apartamento multithread, o chamador será bloqueado até que WaitMultiple 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 objidlbase.h (inclua ObjIdl.h)

Confira também

CoWaitForMultipleHandles

ISynchronizeContainer