InitializeThreadpoolEnvironment function (winbase.h)

Articolo
03/13/2024

Inizializza un ambiente di callback.

Sintassi

void InitializeThreadpoolEnvironment(
  [out] PTP_CALLBACK_ENVIRON pcbe
);

Parametri

[out] pcbe

Struttura TP_CALLBACK_ENVIRON che definisce un ambiente di callback.

Valore restituito

nessuno

Osservazioni

Per impostazione predefinita, un callback viene eseguito nel pool di thread predefinito per il processo. Nessun gruppo di pulizia è associato all'ambiente di callback, il chiamante è responsabile del mantenimento del caricamento della DLL del callback mentre sono presenti callback in sospeso e il callback deve essere eseguito in un periodo ragionevole di tempo per l'applicazione.

Creare un ambiente di callback se si prevede di chiamare una delle funzioni seguenti per modificare l'ambiente:

Per usare l'ambiente di callback predefinito, impostare il parametro di ambiente di callback facoltativo su NULL quando si chiama una delle funzioni seguenti:

La funzione InitializeThreadpoolEnvironment viene implementata come funzione inline.

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

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)