Função InitializeThreadpoolEnvironment (winbase.h)

Artigo
03/13/2024

Inicializa um ambiente de retorno de chamada.

Sintaxe

void InitializeThreadpoolEnvironment(
  [out] PTP_CALLBACK_ENVIRON pcbe
);

Parâmetros

[out] pcbe

Uma estrutura TP_CALLBACK_ENVIRON que define um ambiente de retorno de chamada.

Retornar valor

Nenhum

Comentários

Por padrão, um retorno de chamada é executado no pool de threads padrão para o processo. Nenhum grupo de limpeza está associado ao ambiente de retorno de chamada, o chamador é responsável por manter a DLL do retorno de chamada carregada enquanto há retornos de chamada pendentes e espera-se que o retorno de chamada seja executado em um período razoável para o aplicativo.

Crie um ambiente de retorno de chamada se você planeja chamar uma das seguintes funções para modificar o ambiente:

Para usar o ambiente de retorno de chamada padrão, defina o parâmetro de ambiente de retorno de chamada opcional como NULL ao chamar uma das seguintes funções:

A função InitializeThreadpoolEnvironment é implementada como uma função embutida.

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	winbase.h (incluir Windows.h)