ISynchronizeContainer::WaitMultiple-Methode (objidlbase.h)

  • Artikel

Wartet, bis jedes Synchronisierungsobjekt im Container signalisiert wird oder dass ein festgelegter Timeoutzeitraum verstrichen ist, je nachdem, welcher Zeitpunkt zuerst eintritt.

Syntax

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

Parameter

[in] dwFlags

Die Warteoptionen. Mögliche Werte werden der COWAIT_FLAGS-Enumeration entnommen. 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 UNENDLICH 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 auf dem signalisierten Synchronisierungsobjekt. 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
 Es sind keine Synchronisierungsobjekte im Container vorhanden.

Hinweise

Wenn der Aufrufer in einem Singlethread-Apartment wartet, tritt WaitMultiple in die modale COM-Schleife ein. Wenn der Aufrufer in einem Multithread-Apartment wartet, wird der Aufrufer blockiert, bis WaitMultiple zurückgibt.

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 objidlbase.h (include ObjIdl.h)

Weitere Informationen

CoWaitForMultipleHandles

ISynchronizeContainer