Compartilhar via

Função CreateThreadpoolCleanupGroup (threadpoolapiset.h)

  • Artigo

Cria um grupo de limpeza que os aplicativos podem usar para rastrear um ou mais retornos de chamada do pool de threads.

Sintaxe

PTP_CLEANUP_GROUP CreateThreadpoolCleanupGroup();

Retornar valor

Se a função for bem-sucedida, ela retornará um ponteiro para uma estrutura TP_CLEANUP_GROUP do grupo de limpeza recém-alocado. Os aplicativos não modificam os membros dessa estrutura.

Se a função falhar, ela retornará NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

Depois de criar o grupo de limpeza, chame SetThreadpoolCallbackCleanupGroup para associar o grupo de limpeza a um ambiente de retorno de chamada.

Um membro é adicionado ao grupo sempre que você chama uma das seguintes funções:

Você usa uma das seguintes funções de fechamento correspondentes para remover um membro do grupo.

Para fechar todos os retornos de chamada, chame CloseThreadpoolCleanupGroupMembers.

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

CloseThreadpoolCleanupGroup

CloseThreadpoolCleanupGroupMembers

SetThreadpoolCallbackCleanupGroup

Pools de threads