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:
- SetThreadpoolCallbackCleanupGroup
- SetThreadpoolCallbackLibrary
- SetThreadpoolCallbackPool
- SetThreadpoolCallbackPriority
- SetThreadpoolCallbackRunsLong
- CreateThreadpoolIo
- CreateThreadpoolTimer
- CreateThreadpoolWait
- CreateThreadpoolWork
- TrySubmitThreadpoolCallback
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) |