Partager via

IHostThreadPoolManager ::QueueUserWorkItem, méthode

Met en file d’attente une fonction pour l’exécution et spécifie un objet contenant des données à utiliser par cette fonction. La fonction s’exécute lorsqu’un thread devient disponible.

Syntaxe

HRESULT QueueUserWorkItem (
    [in] LPTHREAD_START_ROUTINE Function,
    [in] PVOID Context,
    [in] ULONG Flags
);

Paramètres

Function [in] Pointeur de fonction qui représente la fonction à exécuter.

Context [in] Objet qui contient des données à utiliser par Function.

Flags [in] Une des valeurs d’indicateurs, telle que définie pour la méthode Win32 QueueUserWorkItem , qui contrôle l’exécution.

Valeur de retour

HRESULT Description
S_OK QueueUserWorkItem retourné avec succès.
HOST_E_CLRNOTAVAILABLE Le Common Language Runtime (CLR) n’a pas été chargé dans un processus, ou le CLR est dans un état dans lequel il ne peut pas exécuter le code managé ou traiter l’appel avec succès.
HOST_E_TIMEOUT L’appel a expiré.
HOST_E_NOT_OWNER L’appelant ne possède pas le verrou.
HOST_E_ABANDONED Un événement a été annulé pendant qu’un thread bloqué ou fibre attendait dessus.
E_FAIL Une défaillance catastrophique inconnue s’est produite. Lorsqu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement retournent HOST_E_CLRNOTAVAILABLE.

Remarques

QueueUserWorkItem met en file d’attente un élément de travail vers un thread de travail dans le pool de threads. Ses types de signature et de paramètre sont identiques à ceux de la fonction Win32 correspondante, qui porte le même nom. Pour plus d’informations, consultez la documentation de la plateforme Windows.

Exigences

Plateformes : Consultez Configuration requise.

En-tête: MSCorEE.h

Bibliothèque: Inclus en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : Disponible depuis la version 2.0

Voir également

  • Last updated on