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

Vedere anche

CreateThreadpoolWait

SetThreadpoolWait

SetThreadpoolWaitEx

Pool di thread

WaitForThreadpoolWaitCallbacks