CreateThreadpoolCleanupGroup, fonction (threadpoolapiset.h)
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
CloseThreadpoolCleanupGroupMembers