Função CloseThreadpoolWait (threadpoolapiset.h)

Libera o objeto de espera especificado.

Sintaxe

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

Parâmetros

[in, out] pwa

Um ponteiro para uma estrutura TP_WAIT que define o objeto de espera. A função CreateThreadpoolWait retorna esse ponteiro.

Retornar valor

Nenhum

Comentários

O objeto wait será liberado imediatamente se não houver retornos de chamada pendentes; caso contrário, o objeto de temporizador é liberado de forma assíncrona após a conclusão dos retornos de chamada pendentes.

Em alguns casos, as funções de retorno de chamada podem ser executadas após CloseThreadpoolWait ter sido chamado. Para evitar esse comportamento:

• Chame a função SetThreadpoolWait ou a função SetThreadpoolWaitEx com o parâmetro h definido como NULL.
• Chame a função WaitForThreadpoolWaitCallbacks com o parâmetro fCancelPendingCallbacks definido como TRUE.
• Chame CloseThreadpoolWait.

Se houver um grupo de limpeza associado ao objeto de espera, não será necessário chamar essa função; chamar a função CloseThreadpoolCleanupGroupMembers libera os objetos de trabalho, espera e temporizador associados ao grupo de limpeza.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou superior.

Exemplos

Para obter um exemplo, consulte Usando as funções do pool de threads.

Requisitos

Confira também

CreateThreadpoolWait

SetThreadpoolWait

SetThreadpoolWaitEx

Pools de threads

WaitForThreadpoolWaitCallbacks