Funzione CreateTimerQueue (threadpoollegacyapiset.h)

Articolo
03/02/2024

Crea una coda per i timer. I timer della coda timer sono oggetti leggeri che consentono di specificare una funzione di callback da chiamare in un momento specificato.

Sintassi

HANDLE CreateTimerQueue();

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per la coda timer. Questo handle può essere usato solo nelle funzioni che richiedono un handle per una coda timer.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per aggiungere un timer alla coda, chiamare la funzione CreateTimerQueueTimer . Per rimuovere un timer dalla coda, chiamare la funzione DeleteTimerQueueTimer .

Al termine della coda dei timer, chiamare la funzione DeleteTimerQueueEx per eliminare la coda timer. Tutti i timer in sospeso nella coda vengono annullati ed eliminati.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Esempio

Per un esempio che usa CreateTimerQueue, vedere Uso di code timer.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	threadpoollegacyapiset.h
Libreria	Kernel32.lib
DLL	Kernel32.dll