Fonction InitializeThreadpoolEnvironment (winbase.h)

Article
08/27/2023

Initialise un environnement de rappel.

Syntaxe

void InitializeThreadpoolEnvironment(
  [out] PTP_CALLBACK_ENVIRON pcbe
);

Paramètres

[out] pcbe

Structure TP_CALLBACK_ENVIRON qui définit un environnement de rappel.

Valeur de retour

None

Remarques

Par défaut, un rappel s’exécute dans le pool de threads par défaut pour le processus. Aucun groupe de nettoyage n’est associé à l’environnement de rappel, l’appelant est responsable du chargement de la DLL du rappel tant que des rappels sont en suspens, et le rappel est censé s’exécuter dans un délai raisonnable pour l’application.

Créez un environnement de rappel si vous envisagez d’appeler l’une des fonctions suivantes pour modifier l’environnement :

Pour utiliser l’environnement de rappel par défaut, définissez le paramètre d’environnement de rappel facultatif sur NULL lors de l’appel de l’une des fonctions suivantes :

La fonction InitializeThreadpoolEnvironment est implémentée en tant que fonction inline.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou une version ultérieure.

Exemples

Pour obtenir un exemple, consultez Utilisation des fonctions de pool de threads.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)