Función CreateThreadpool (threadpoolapiset.h)

Asigna un nuevo grupo de subprocesos para ejecutar devoluciones de llamada.

Sintaxis

PTP_POOL CreateThreadpool(
  PVOID reserved
);

Parámetros

reserved

Este parámetro está reservado y debe ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un puntero a una estructura de TP_POOL que representa el grupo de subprocesos recién asignado. Las aplicaciones no modifican los miembros de esta estructura.

Si se produce un error en la función, devuelve NULL. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

Después de crear el nuevo grupo de subprocesos, debe llamar a SetThreadpoolThreadMaximum para especificar el número máximo de subprocesos que el grupo puede asignar y SetThreadpoolThreadMinimum para especificar el número mínimo de subprocesos disponibles en el grupo.

Para usar el grupo, debe asociar el grupo a un entorno de devolución de llamada. Para crear el entorno de devolución de llamada, llame a InitializeThreadpoolEnvironment. A continuación, llame a SetThreadpoolCallbackPool para asociar el grupo con el entorno de devolución de llamada.

Para liberar el grupo de subprocesos, llame a CloseThreadpool.

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	threadpoolapiset.h (incluya Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

CloseThreadpool

SetThreadpoolThreadMaximum

SetThreadpoolThreadMinimum

Grupos de subprocesos