Función CreateThreadpoolTimer (threadpoolapiset.h)

Artículo
03/08/2023

Crea un nuevo objeto de temporizador.

Sintaxis

PTP_TIMER CreateThreadpoolTimer(
  [in]                PTP_TIMER_CALLBACK   pfnti,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Parámetros

[in] pfnti

Función de devolución de llamada que se va a llamar cada vez que expira el objeto de temporizador. Para más información, consulte TimerCallback.

[in, out, optional] pv

Datos opcionales definidos por la aplicación que se van a 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 ejecuta correctamente, devuelve un puntero a una estructura TP_TIMER que define el objeto de temporizador. 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 de temporizador, llame a la función SetThreadpoolTimer .

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


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