Condividi tramite


Funzione CreateTimerQueue (threadpoollegacyapiset.h)

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

Vedere anche

CreateTimerQueueTimer

DeleteTimerQueueEx

DeleteTimerQueueTimer

Funzioni di sincronizzazione

Pooling dei thread

Code timer