ISynchronizeContainer::WaitMultiple-Methode (objidl.h)

  • Artikel

Wartet darauf, dass jedes Synchronisierungsobjekt im Container signalisiert wird oder ein festgelegter Timeoutzeitraum abläuft, je nachdem, was zuerst eintritt.

Syntax

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

Parameter

[in] dwFlags

Die Warteoptionen. Mögliche Werte stammen aus der COWAIT_FLAGS-Enumeration . COWAIT_WAITALL ist keine gültige Einstellung für diese Methode.

[in] dwTimeOut

Die Zeit, die dieser Aufruf wartet, bevor er zurückgegeben wird, in Millisekunden. Wenn dieser Parameter INFINITE ist, wartet der Aufrufer, bis ein Synchronisierungsobjekt signalisiert wird, unabhängig davon, wie lange es dauert. Wenn dieser Parameter 0 ist, gibt die Methode sofort zurück.

[out] ppSync

Ein Zeiger auf einen ISynchronize-Schnittstellenzeiger für das Synchronisierungsobjekt, das signalisiert wurde. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Das Synchronisierungsobjekt wurde signalisiert.
RPC_E_TIMEOUT
 Der Timeoutzeitraum, der verstrichen ist, bevor das Synchronisierungsobjekt signalisiert wurde.
RPC_E_NO_SYNC
 Der Container enthält keine Synchronisierungsobjekte.

Hinweise

Wenn der Aufrufer in einem Singlethread-Apartment wartet, wechselt WaitMultiple in die modale COM-Schleife. Wenn der Aufrufer in einer Multithread-Wohnung wartet, wird der Aufrufer blockiert, bis WaitMultiple zurückgegeben wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h (include ObjIdl.h)

Weitere Informationen

CoWaitForMultipleHandles

ISynchronizeContainer