Função CreateThreadpoolCleanupGroup (threadpoolapiset.h)
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
CloseThreadpoolCleanupGroupMembers