IHostTaskManager::CreateTask, méthode

Article
05/10/2023

Demande à l’hôte de créer une tâche.

Syntaxe

HRESULT CreateTask (  
    [in]  DWORD stacksize,
    [in]  LPTHREAD_START_ROUTINE pStartAddress,  
    [in]  PVOID pParameter,  
    [out] IHostTask **ppTask  
);

Paramètres

stacksize
[in] Taille demandée, en octets, de la pile demandée ou 0 (zéro) pour la taille par défaut.

pStartAddress
[in] Un pointeur vers la fonction que la tâche doit exécuter.

pParameter
[in] Pointeur vers les données utilisateur à transmettre à la fonction ou null si la fonction ne prend aucun paramètre.

ppTask
[out] Pointeur vers l’adresse d’une instance IHostTask créée par l’hôte ou null si la tâche ne peut pas être créée. La tâche reste dans un état suspendu jusqu’à ce qu’elle soit explicitement démarrée par un appel à IHostTask::Start.

Valeur de retour

HRESULT	Description
S_OK	`CreateTask` 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.
E_OUTOFMEMORY	La mémoire était insuffisante pour créer la tâche demandée.

Notes

Le CLR appelle CreateTask pour demander que l’hôte crée une tâche. L’hôte retourne un pointeur d’interface vers une instance IHostTask. La tâche retournée doit rester suspendue jusqu’à ce qu’elle soit explicitement démarrée par un appel à 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

Partager via