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:

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

Confira também

CreateThreadpoolWait

SetThreadpoolWait

SetThreadpoolWaitEx

Pools de threads

WaitForThreadpoolWaitCallbacks