UnregisterWait-Funktion (winbase.h)
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 |