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 |