Freigeben über


CancelWaitableTimer-Funktion (synchapi.h)

Legt den angegebenen wartebaren Timer auf den inaktiven Zustand fest.

Syntax

BOOL CancelWaitableTimer(
  [in] HANDLE hTimer
);

Parameter

[in] hTimer

Ein Handle für das Timerobjekt. Die Funktion CreateWaitableTimer oder OpenWaitableTimer gibt dieses Handle zurück. Das Handle muss über das zugriffsrecht TIMER_MODIFY_STATE verfügen. Weitere Informationen finden Sie unter Synchronisierungsobjektsicherheit und Zugriffsrechte.

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

Die CancelWaitableTimer-Funktion ändert den Signalzustand des Timers nicht. Er beendet den Timer, bevor er auf den signalierten Zustand eingestellt werden kann, und bricht ausstehende APCs ab. Daher warten Threads, die einen Wartevorgang auf dem Timer ausführen, bis sie ein Timeout ausführen oder der Timer reaktiviert wird und sein Zustand auf Signal festgelegt ist. Wenn sich der Timer bereits im signalierten Zustand befindet, bleibt er in diesem Zustand.

Um den Timer erneut zu aktivieren, rufen Sie die SetWaitableTimer-Funktion auf.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile synchapi.h (einschließlich Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CreateWaitableTimer

OpenWaitableTimer

SetWaitableTimer

Synchronisierungsfunktionen

Wartebare Timerobjekte