Méthode ISynchronizeContainer ::WaitMultiple (objidl.h)

Article
02/29/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 revenir, en millisecondes. Si ce paramètre est INFINITE, l’appelant attend qu’un objet de synchronisation soit signalé, quel que soit le temps nécessaire. Si ce paramètre a la valeur 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 être 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’attente s’est écoulé avant que l’objet de synchronisation soit signalé.
RPC_E_NO_SYNC	Il n’y a 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 est en attente dans un appartement multithread, l’appelant est bloqué jusqu’au retour de WaitMultiple .

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	objidl.h (inclure ObjIdl.h)

Voir aussi

CoWaitForMultipleHandles

ISynchronizeContainer

Partager via