Funzione CloseThreadpoolWait (threadpoolapiset.h)

Articolo
03/05/2024

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