ISynchronizeContainer ::WaitMultiple, méthode (objidlbase.h)

Article
03/06/2024

Attend que tout objet de synchronisation dans le conteneur soit signalé ou qu’un délai d’expiration spécifié s’écoule, selon la première éventualité.

Syntaxe

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

Paramètres

[in] dwFlags

Options d’attente. Les valeurs possibles sont extraites de l’énumération COWAIT_FLAGS . COWAIT_WAITALL n’est pas un paramètre valide pour cette méthode.

[in] dwTimeOut

Durée d’attente de cet appel avant de retourner, en millisecondes. Si ce paramètre est INFINITE, l’appelant attend qu’un objet de synchronisation soit signalé, quelle que soit la durée nécessaire. Si ce paramètre est 0, la méthode retourne immédiatement.

[out] ppSync

Pointeur vers un pointeur d’interface ISynchronize sur l’objet de synchronisation signalé. Ce paramètre ne peut pas avoir la valeur NULL.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et E_FAIL, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	L’objet de synchronisation a été signalé.
RPC_E_TIMEOUT	Le délai d’expiration s’est écoulé avant que l’objet de synchronisation soit signalé.
RPC_E_NO_SYNC	Il n’existe aucun objet de synchronisation dans le conteneur.

Remarques

Si l’appelant est en attente dans un appartement à thread unique, WaitMultiple entre dans la boucle modale COM. Si l’appelant attend dans un appartement multithread, l’appelant est bloqué jusqu’à ce que WaitMultiple retourne.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	objidlbase.h (inclure ObjIdl.h)

Voir aussi

CoWaitForMultipleHandles

ISynchronizeContainer

Partager via