ICLRTaskManager::CreateTask, méthode
Demande explicitement au Common Language Runtime (CLR) de créer une tâche.
Syntaxe
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Paramètres
pTask
[out] Pointeur vers l’adresse d’un ICLRTask récemment créé ou null si la tâche n’a pas pu être créée.
Valeur de retour
| HRESULT | Description |
|---|---|
| S_OK | Retour réussi de la méthode. |
| HOST_E_CLRNOTAVAILABLE | Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement. |
| 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. |
| E_OUTOFMEMORY | La mémoire disponible est insuffisante pour allouer la ressource demandée. |
Notes
Le CLR crée automatiquement une tâche lors de l’initialisation, lorsque le code utilisateur crée un thread avec des types dans l’espace de noms System.Threading ou lorsque la taille du pool de threads est augmentée. Il crée également des tâches lorsque du code non managé appelle une fonction managée.
CreateTask permet à l’hôte de demander explicitement au CLR de créer une tâche. Par exemple, l’hôte peut appeler cette méthode pour préinitialiser des structures de données.
Important
La nouvelle tâche est retournée dans un état suspendu et reste dans cet état jusqu’à ce que l’hôte appelle explicitement IHostTask::Start.
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
