CreateTimerQueue-Funktion (threadpoollegacyapiset.h)
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 |