DeleteTimerQueue-Funktion (threadpoollegacyapiset.h)

Artikel
08/26/2023

Löscht eine Timerwarteschlange. Alle ausstehenden Timer in der Warteschlange werden abgebrochen und gelöscht.

Hinweis Diese Funktion ist veraltet und wurde durch die DeleteTimerQueueEx-Funktion ersetzt.

Syntax

BOOL DeleteTimerQueue(
  HANDLE TimerQueue
);

Parameter

TimerQueue

Ein Handle für die Zeitgeberwarteschlange. Dieses Handle wird von der CreateTimerQueue-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

DeleteTimerQueue wartet nicht auf den Abschluss aller Rückruffunktionen, die dem Timer zugeordnet sind.

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.

Beispiele

Ein Beispiel für die Verwendung von DeleteTimerQueue finden Sie unter Verwenden von Timerwarteschlangen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	threadpoollegacyapiset.h
Bibliothek	Kernel32.lib
DLL	Kernel32.lib