CreateTimerQueue-Funktion (threadpoollegacyapiset.h)

Artikel
03/04/2024

Erstellt eine Warteschlange für Zeitgeber. Timer-Queue-Timer sind einfache Objekte, mit denen Sie eine Rückruffunktion angeben können, die zu einem bestimmten Zeitpunkt aufgerufen werden soll.

Syntax

HANDLE CreateTimerQueue();

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Timerwarteschlange. Dieses Handle kann nur in Funktionen verwendet werden, die ein Handle für eine Timerwarteschlange erfordern.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Um der Warteschlange einen Timer hinzuzufügen, rufen Sie die Funktion CreateTimerQueueTimer auf. Um einen Timer aus der Warteschlange zu entfernen, rufen Sie die DeleteTimerQueueTimer-Funktion auf.

Wenn Sie mit der Timerwarteschlange fertig sind, rufen Sie die DeleteTimerQueueEx-Funktion auf, um die Timerwarteschlange zu löschen. Alle ausstehenden Timer in der Warteschlange werden abgebrochen und gelöscht.

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, das CreateTimerQueue verwendet, finden Sie unter Verwenden von Timerwarteschlangen.

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	threadpoollegacyapiset.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll