Función CreateThreadpoolWork (threadpoolapiset.h)
Crea un nuevo objeto de trabajo.
Sintaxis
PTP_WORK CreateThreadpoolWork(
[in] PTP_WORK_CALLBACK pfnwk,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
Parámetros
[in] pfnwk
La función de devolución de llamada. Un subproceso de trabajo llama a esta devolución de llamada cada vez que llama a SubmitThreadpoolWork para publicar el objeto de trabajo. Para obtener más información, consulte WorkCallback.
[in, out, optional] pv
Datos opcionales definidos por la aplicación para pasar a la función de devolución de llamada.
[in, optional] pcbe
Puntero a una estructura TP_CALLBACK_ENVIRON que define el entorno en el que se va a ejecutar la devolución de llamada. Use la función InitializeThreadpoolEnvironment para inicializar la estructura antes de llamar a esta función.
Si este parámetro es NULL, la devolución de llamada se ejecuta en el entorno de devolución de llamada predeterminado. Para obtener más información, vea InitializeThreadpoolEnvironment.
Valor devuelto
Si la función se ejecuta correctamente, devuelve un puntero a una estructura TP_WORK que define el objeto de trabajo. 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
Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0600 o superior.
Ejemplos
Para obtener un ejemplo, vea 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) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |