Funzione CreateThreadpoolTimer (threadpoolapiset.h)

Articolo
08/26/2023

Crea un nuovo oggetto timer.

Sintassi

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

Parametri

[in] pfnti

Funzione di callback da chiamare ogni volta che l'oggetto timer scade. Per informazioni dettagliate, vedere TimerCallback.

[in, out, optional] pv

Dati facoltativi definiti dall'applicazione da passare alla funzione di callback.

[in, optional] pcbe

Struttura TP_CALLBACK_ENVIRON che definisce l'ambiente in cui eseguire il callback. La funzione InitializeThreadpoolEnvironment restituisce questa struttura.

Se questo parametro è NULL, il callback viene eseguito nell'ambiente di callback predefinito. Per altre informazioni, vedere InitializeThreadpoolEnvironment.

Valore restituito

Se la funzione ha esito positivo, restituisce un puntatore a una struttura TP_TIMER che definisce l'oggetto timer. Le applicazioni non modificano i membri di questa struttura.

Se la funzione ha esito negativo, restituisce NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Per impostare l'oggetto timer, chiamare la funzione SetThreadpoolTimer .

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.

Esempio

Per un esempio, vedere Uso delle funzioni del pool di thread.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	threadpoolapiset.h (include Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll