IHostThreadPoolManager::QueueUserWorkItem, méthode

Article
05/10/2023

Place une fonction en file d’attente pour exécution et spécifie un objet contenant les données que la fonction doit utiliser. 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 contenant les données que Function doit utiliser.

Flags
[in] Une des valeurs d’indicateur, comme défini pour la méthode QueueUserWorkItem Win32, qui contrôle l’exécution.

Valeur de retour

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

Notes

QueueUserWorkItem met en file d’attente un élément de travail vers un thread Worker dans le pool de threads. Sa signature et ses types de paramètres 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 .

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 2.0

Partager via