Partager via


TrySubmitThreadpoolCallback, fonction (threadpoolapiset.h)

Demande qu’un thread worker de pool de threads appelle la fonction de rappel spécifiée.

Syntaxe

BOOL TrySubmitThreadpoolCallback(
  [in]                PTP_SIMPLE_CALLBACK  pfns,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Paramètres

[in] pfns

Fonction de rappel. Pour plus d’informations, consultez SimpleCallback.

[in, out, optional] pv

Données facultatives définies par l’application à passer à la fonction de rappel.

[in, optional] pcbe

Pointeur vers une structure TP_CALLBACK_ENVIRON qui définit l’environnement dans lequel exécuter la fonction de 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 TRUE.

Si la fonction échoue, elle retourne FALSE. 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.

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

CallbackMayRunLong

DisassociateCurrentThreadFromCallback

FreeLibraryWhenCallbackReturns

InitializeThreadpoolEnvironment

LeaveCriticalSectionWhenCallbackReturns

ReleaseMutexWhenCallbackReturns

ReleaseSemaphoreWhenCallbackReturns

SetEventWhenCallbackReturns

Pools de threads