CreateThreadpoolWork, fonction (threadpoolapiset.h)
Crée un objet de travail.
Syntaxe
PTP_WORK CreateThreadpoolWork(
[in] PTP_WORK_CALLBACK pfnwk,
[in, out, optional] PVOID pv,
[in, optional] PTP_CALLBACK_ENVIRON pcbe
);
Paramètres
[in] pfnwk
Fonction de rappel. Un thread de travail appelle ce rappel chaque fois que vous appelez SubmitThreadpoolWork pour publier l’objet de travail. Pour plus d’informations, consultez WorkCallback.
[in, out, optional] pv
Données facultatives définies par l’application à passer à la fonction de rappel.
[in, optional] pcbe
Pointeur vers une structure de TP_CALLBACK_ENVIRON qui définit l’environnement dans lequel exécuter le rappel. Utilisez la fonction InitializeThreadpoolEnvironment pour initialiser la structure avant d’appeler cette fonction.
Si ce paramètre a la valeur NULL, le rappel s’exécute dans l’environnement de rappel par défaut. Pour plus d’informations, consultez InitializeThreadpoolEnvironment.
Valeur retournée
Si la fonction réussit, elle retourne un pointeur vers une structure TP_WORK qui définit l’objet de travail. Les applications ne modifient pas les membres de cette structure.
Si la fonction échoue, elle retourne NULL. Pour récupérer des informations d’erreur étendues, appelez GetLastError.
Remarques
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) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |