Compartir a través de

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

  • Artículo

Espera a que cualquier objeto de sincronización del contenedor se indique o que haya transcurrido un período de tiempo de espera especificado, lo que ocurra primero.

Sintaxis

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

Parámetros

[in] dwFlags

Opciones de espera. Los valores posibles se toman de la enumeración COWAIT_FLAGS . COWAIT_WAITALL no es una configuración válida para este método.

[in] dwTimeOut

El tiempo que esta llamada esperará antes de volver, en milisegundos. Si este parámetro es INFINITE, el autor de la llamada esperará hasta que se señale un objeto de sincronización, independientemente del tiempo que tarde. Si este parámetro es 0, el método devuelve inmediatamente.

[out] ppSync

Puntero a un puntero de interfaz ISynchronize en el objeto de sincronización que se señalizó. Este parámetro no puede ser NULL.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_FAIL, así como los valores siguientes.

Código devuelto Descripción
S_OK
 Se señalizó el objeto de sincronización.
RPC_E_TIMEOUT
 El período de tiempo de espera transcurrido antes de que se señalice el objeto de sincronización.
RPC_E_NO_SYNC
 No hay objetos de sincronización en el contenedor.

Comentarios

Si el autor de la llamada está esperando en un apartamento de un solo subproceso, WaitMultiple entra en el bucle modal COM. Si el autor de la llamada está esperando en un apartamento multiproceso, el autor de la llamada se bloquea hasta que WaitMultiple vuelva.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado objidlbase.h (incluya ObjIdl.h)

Consulte también

CoWaitForMultipleHandles

ISynchronizeContainer