ICLRTaskManager::CreateTask, méthode

Article
08/10/2011

Demande explicitement que le Common Language Runtime (CLR) crée une nouvelle tâche.

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 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.
E_OUTOFMEMORY	La mémoire disponible est insuffisante pour allouer la ressource demandée.

Notes

Le CLR crée automatiquement une nouvelle tâche au moment de l'initialisation, lorsque le code utilisateur crée un thread à l'aide de types figurant 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 que le CLR crée une nouvelle tâche. Par exemple, l'hôte peut appeler cette méthode pour préinitialiser des structures de données.