Compartilhar via


Função InitializeThreadpoolEnvironment (winbase.h)

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)

Confira também

DestroyThreadpoolEnvironment

SetThreadpoolCallbackCleanupGroup

SetThreadpoolCallbackLibrary

SetThreadpoolCallbackPool

SetThreadpoolCallbackRunsLong

Pools de threads