Compartir a través de


Función CreateThreadpoolWait (threadpoolapiset.h)

Crea un nuevo objeto wait.

Sintaxis

PTP_WAIT CreateThreadpoolWait(
  [in]                PTP_WAIT_CALLBACK    pfnwa,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Parámetros

[in] pfnwa

Función de devolución de llamada que se va a llamar cuando se completa la espera o se agota el tiempo de espera. Para obtener más información, consulte WaitCallback.

[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

Estructura TP_CALLBACK_ENVIRON que define el entorno en el que se va a ejecutar la devolución de llamada. La función InitializeThreadpoolEnvironment devuelve esta estructura.

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 realiza correctamente, devuelve un puntero a una estructura TP_WAIT que define el objeto wait. 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 establecer el objeto wait, llame a la función SetThreadpoolWait o SetThreadpoolWaitEx .

El elemento de trabajo y todas las funciones a las que llama no deben confiar en el subproceso después de que se hayan devuelto. Por lo tanto, no se puede llamar a una llamada asincrónica que requiera un subproceso persistente, como la función RegNotifyChangeKeyValue sin la marca REG_NOTIFY_THREAD_AGNOSTIC , desde el entorno de devolución de llamada predeterminado. En su lugar, use un subproceso cuya duración controle.

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

   
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

CloseThreadpoolWait

SetThreadpoolWait

Grupos de subprocesos

WaitForThreadpoolWaitCallbacks