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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | threadpoolapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |