Funzione DeleteTimerQueueEx (threadpoollegacyapiset.h)

Articolo
03/05/2024

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