Funzione DeleteTimerQueueEx (threadpoollegacyapiset.h)
Elimina una coda timer. Tutti i timer in sospeso nella coda vengono annullati ed eliminati.
Sintassi
BOOL DeleteTimerQueueEx(
[in] HANDLE TimerQueue,
[in, optional] HANDLE CompletionEvent
);
Parametri
[in] TimerQueue
Handle per la coda timer. Questo handle viene restituito dalla funzione CreateTimerQueue .
[in, optional] CompletionEvent
Handle per l'oggetto evento da segnalare quando la funzione ha esito positivo e tutte le funzioni di callback sono state completate. Questo parametro può essere NULL.
Se questo parametro è INVALID_HANDLE_VALUE, la funzione attende il completamento di tutte le funzioni di callback prima della restituzione.
Se questo parametro è NULL, la funzione contrassegna il timer per l'eliminazione e restituisce immediatamente. Tuttavia, la maggior parte dei chiamanti deve attendere il completamento della funzione di callback in modo da poter eseguire qualsiasi pulizia necessaria.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Non effettuare chiamate di blocco a DeleteTimerQueueEx dall'interno di un callback timer.
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.
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 |