Condividi tramite


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

Vedere anche

CreateTimerQueue

DeleteTimerQueueTimer

Funzioni di sincronizzazione

Pooling dei thread

Code timer