Función CreateThreadpoolWork (threadpoolapiset.h)

  • Artículo

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

Vea también

CloseThreadpoolWork

SubmitThreadpoolWork

Grupos de subprocesos

WaitForThreadpoolWorkCallbacks