Funzione CloseThreadpoolTimer (threadpoolapiset.h)
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 |