UnregisterWait-Funktion (winbase.h)

  • Artikel

Bricht einen registrierten Wartevorgang ab, der von der RegisterWaitForSingleObject-Funktion ausgegeben wird.

Um ein Vervollständigungsereignis zu verwenden, rufen Sie die UnregisterWaitEx-Funktion auf.

Syntax

BOOL UnregisterWait(
  [in] HANDLE WaitHandle
);

Parameter

[in] WaitHandle

Das Wait-Handle. Dieses Handle wird von der RegisterWaitForSingleObject-Funktion zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn Rückruffunktionen, die dem Timer zugeordnet sind, beim Aufruf von UnregisterWait nicht abgeschlossen wurden, hebt UnregisterWait die Registrierung der Wait für die Rückruffunktionen auf und schlägt mit dem fehlercode ERROR_IO_PENDING fehl. Der Fehlercode gibt nicht an, dass die Funktion fehlgeschlagen ist, und die Funktion muss nicht erneut aufgerufen werden. Wenn für Ihren Code ein Fehlercode erforderlich ist, der nur festgelegt werden soll, wenn der Vorgang zum Aufheben der Registrierung fehlgeschlagen ist, rufen Sie stattdessen UnregisterWaitEx auf.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0500 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Registerwaitforsingleobject

Synchronisierungsfunktionen

Pooling von Threads

UnregisterWaitEx