Función InitializeThreadpoolEnvironment (winbase.h)

Artículo
08/27/2023

Inicializa un entorno de devolución de llamada.

Sintaxis

void InitializeThreadpoolEnvironment(
  [out] PTP_CALLBACK_ENVIRON pcbe
);

Parámetros

[out] pcbe

Estructura TP_CALLBACK_ENVIRON que define un entorno de devolución de llamada.

Valor devuelto

None

Observaciones

De forma predeterminada, una devolución de llamada se ejecuta en el grupo de subprocesos predeterminado para el proceso. No hay ningún grupo de limpieza asociado al entorno de devolución de llamada, el autor de la llamada es responsable de mantener el archivo DLL de la devolución de llamada cargado mientras hay devoluciones de llamada pendientes y se espera que la devolución de llamada se ejecute en un período de tiempo razonable para la aplicación.

Cree un entorno de devolución de llamada si tiene previsto llamar a una de las siguientes funciones para modificar el entorno:

Para usar el entorno de devolución de llamada predeterminado, establezca el parámetro opcional del entorno de devolución de llamada en NULL al llamar a una de las siguientes funciones:

La función InitializeThreadpoolEnvironment se implementa como una función insertada.

Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o superior.

Ejemplos

Para obtener un ejemplo, consulte Uso de las funciones del grupo de subprocesos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)