Función CloseThreadpoolWait (threadpoolapiset.h)

Libera el objeto de espera especificado.

Sintaxis

void CloseThreadpoolWait(
  [in, out] PTP_WAIT pwa
);

Parámetros

[in, out] pwa

Puntero a una estructura TP_WAIT que define el objeto wait. La función CreateThreadpoolWait devuelve este puntero.

Valor devuelto

None

Observaciones

El objeto wait se libera inmediatamente si no hay devoluciones de llamada pendientes; de lo contrario, el objeto de temporizador se libera de forma asincrónica después de que se completen las devoluciones de llamada pendientes.

En algunos casos, las funciones de devolución de llamada se pueden ejecutar después de llamar a CloseThreadpoolWait . Para evitar este comportamiento:

• Llame a la función SetThreadpoolWait o a la función SetThreadpoolWaitEx con el parámetro h establecido en NULL.
• Llame a la función WaitForThreadpoolWaitCallbacks con el parámetro fCancelPendingCallbacks establecido en TRUE.
• Llame a CloseThreadpoolWait.

Si hay un grupo de limpieza asociado al objeto wait, no es necesario llamar a esta función; Al llamar a la función CloseThreadpoolCleanupGroupMembers , se liberan los objetos de trabajo, espera y temporizador asociados al grupo de limpieza.

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o superior.

Ejemplos

Para obtener un ejemplo, consulte Uso de las funciones del grupo de subprocesos.

Requisitos

Vea también

CreateThreadpoolWait

SetThreadpoolWait

SetThreadpoolWaitEx

Grupos de subprocesos

WaitForThreadpoolWaitCallbacks