ISynchronizeContainer::WaitMultiple-Methode (objidlbase.h)
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 |
|---|---|
|
Das Synchronisierungsobjekt wurde signalisiert. |
|
Der Timeoutzeitraum, der verstrichen ist, bevor das Synchronisierungsobjekt signalisiert wurde. |
|
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) |