ISynchronize::Wait-Methode (objidl.h)

  • Artikel

Wartet, bis das Synchronisierungsobjekt signalisiert wird oder ein festgelegter Timeoutzeitraum verstreicht, je nachdem, welcher Zeitpunkt zuerst eintritt.

Syntax

HRESULT Wait(
  [in] DWORD dwFlags,
  [in] DWORD dwMilliseconds
);

Parameter

[in] dwFlags

Die Warteoptionen. Mögliche Werte werden der COWAIT_FLAGS-Enumeration entnommen.

[in] dwMilliseconds

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

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_S_CALLPENDING
 Der Timeoutzeitraum, der verstrichen ist, bevor das Synchronisierungsobjekt signalisiert wurde.
RPC_E_NO_SYNC
 Es gibt kein Synchronisierungsobjekt, auf das gewartet werden muss.

Hinweise

Wenn der Aufrufer in einem Singlethread-Apartment wartet, wechselt Wait in die modale COM-Schleife. Wenn der Aufrufer in einem Multithread-Apartment wartet, wird der Aufrufer blockiert, bis Wait 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 objidl.h (include ObjIdl.h)

Weitere Informationen

CoWaitForMultipleHandles

ISynchronisieren