IHostThreadPoolManager::QueueUserWorkItem, méthode

Article
08/10/2011

Met en file d'attente une fonction pour l'exécution et spécifie un objet contenant les données que cette fonction doit utiliser. La fonction s'exécute lorsqu'un thread devient disponible.

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

Paramètres

Function
[in] Pointeur de fonction représentant la fonction à exécuter.
Context
[in] Objet contenant les données que la Function doit utiliser.
Flags
[in] Une des valeurs d'indicateurs, définie pour la méthode QueueUserWorkItem Win32 qui contrôle l'exécution.

Valeur de retour

HRESULT	Description
S_OK	QueueUserWorkItem a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de 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é alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et 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.

Notes

QueueUserWorkItem met en file d'attente un élément de travail dans un thread de travail du pool de threads. Ses types de signature et 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.