IHostTaskManager::CreateTask, méthode

Article
08/10/2011

Demande que l'hôte crée une tâche.

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] Pointeur vers la fonction que la tâche doit exécuter.
pParameter
[in] Pointeur vers les données utilisateur à passer à la fonction ou null si la fonction n'utilise 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. L'état de la tâche reste suspendu jusqu'à ce qu'elle soit explicitement démarrée par un appel à IHostTask::Start.

Valeur de retour

HRESULT	Description
S_OK	CreateTask 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.
E_OUTOFMEMORY	Mémoire disponible 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 d'IHostTask. La tâche retournée doit rester suspendue jusqu'à ce qu'elle soit démarrée explicitement par un appel à IHostTask::Start.