Partager via


ICLRTask::YieldTask, méthode

Demande que le Common Language Runtime (CLR) mette de côté la tâche représentée par l'instance ICLRTask actuelle et mette le temps processeur à la disposition d'autres tâches.

HRESULT YieldTask ();

Valeur de retour

HRESULT

Description

S_OK

YieldTask a été retourné avec succès.

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.

Notes

Un hôte appelle YieldTask pour demander des ressources de processeur pour les autres tâches ou processus. Cette méthode est principalement destinée à autoriser le code de longue durée à abandonner le temps processeur. Le runtime essaie de mettre la tâche que représente l'instance ICLRTask actuelle dans un état où elle peut céder du temps de traitement, sans aucune garantie de succès.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

ICLRTask, interface

ICLRTaskManager, interface

IHostTask, interface

IHostTaskManager, interface