Função CloseThreadpoolWait (threadpoolapiset.h)

Artigo
03/13/2024

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