Funzione CloseThreadpoolWait (threadpoolapiset.h)
Rilascia l'oggetto wait specificato.
Sintassi
void CloseThreadpoolWait(
[in, out] PTP_WAIT pwa
);
Parametri
[in, out] pwa
Puntatore a una struttura TP_WAIT che definisce l'oggetto wait. La funzione CreateThreadpoolWait restituisce questo puntatore.
Valore restituito
nessuno
Osservazioni
L'oggetto wait viene liberato immediatamente se non sono presenti callback in sospeso; in caso contrario, l'oggetto timer viene liberato in modo asincrono dopo il completamento dei callback in sospeso.
In alcuni casi, le funzioni di callback potrebbero essere eseguite dopo la chiamata di CloseThreadpoolWait . Per evitare questo comportamento:
- Chiamare la funzione SetThreadpoolWait o SetThreadpoolWaitEx con il parametro h impostato su NULL.
- Chiamare la funzione WaitForThreadpoolWaitCallbacks con il parametro fCancelPendingCallbacks impostato su TRUE.
- Chiamare CloseThreadpoolWait.
Se è presente un gruppo di pulizia associato all'oggetto wait, 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.
Esempio
Per un esempio, vedere Uso delle funzioni del pool di thread.
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 |