Funzione CloseThreadpoolTimer (threadpoolapiset.h)

Articolo
03/02/2024

Rilascia l'oggetto timer specificato.

Sintassi

void CloseThreadpoolTimer(
  [in, out] PTP_TIMER pti
);

Parametri

[in, out] pti

Puntatore alla struttura TP_TIMER che definisce l'oggetto timer. La funzione CreateThreadpoolTimer restituisce questo puntatore.

Valore restituito

nessuno

Osservazioni

L'oggetto timer viene liberato immediatamente se non sono presenti callback in sospeso; in caso contrario, l'oggetto timer viene liberato in modo asincrono dopo il completamento delle funzioni di callback in sospeso.

In alcuni casi, le funzioni di callback potrebbero essere eseguite dopo la chiamata a CloseThreadpoolTimer . Per evitare questo comportamento:

Chiamare la funzione SetThreadpoolTimer o SetThreadpoolTimerEx con il parametro pftDueTime impostato su NULL e i parametri msPeriod e msWindowLength impostati su 0.
Chiamare la funzione WaitForThreadpoolTimerCallbacks con il parametro fCancelPendingCallbacks impostato su TRUE.
Chiamare CloseThreadpoolTimer.

Se è presente un gruppo di pulizia associato all'oggetto timer, non è necessario chiamare questa funzione; chiamando la funzione CloseThreadpoolCleanupGroupMembers rilascia gli oggetti work, wait e timer associati al gruppo di pulizia.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	threadpoolapiset.h (includere Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll