Partager via

CreateThreadpoolCleanupGroup, fonction (threadpoolapiset.h)

  • Article

Crée un groupe de nettoyage que les applications peuvent utiliser pour suivre un ou plusieurs rappels de pool de threads.

Syntaxe

PTP_CLEANUP_GROUP CreateThreadpoolCleanupGroup();

Valeur de retour

Si la fonction réussit, elle retourne un pointeur vers une structure TP_CLEANUP_GROUP du groupe de nettoyage nouvellement alloué. Les applications ne modifient pas les membres de cette structure.

En cas d’échec de la fonction, elle retourne NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Remarques

Après avoir créé le groupe de nettoyage, appelez SetThreadpoolCallbackCleanupGroup pour associer le groupe de nettoyage à un environnement de rappel.

Un membre est ajouté au groupe chaque fois que vous appelez l’une des fonctions suivantes :

Vous utilisez l’une des fonctions de fermeture correspondantes suivantes pour supprimer un membre du groupe.

Pour fermer tous les rappels, appelez CloseThreadpoolCleanupGroupMembers.

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 threadpoolapiset.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CloseThreadpoolCleanupGroup

CloseThreadpoolCleanupGroupMembers

SetThreadpoolCallbackCleanupGroup

Pools de threads