Partager via

ICLRTask::YieldTask, méthode

  • Article

Demande que le Common Language Runtime (CLR) mette de côté la tâche que représente l’instance ICLRTask actuelle et rende le temps processeur disponible pour d’autres tâches.

Syntaxe

HRESULT YieldTask ();

Valeur de retour

HRESULT Description
S_OK YieldTask retourné.
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.

Notes

Un hôte appelle YieldTask pour demander des ressources du processeur pour d’autres tâches ou processus. Cette méthode est principalement destinée à permettre au code de longue durée d’abandonner le temps processeur. Le runtime tente de placer la tâche que l’instance ICLRTask actuelle représente dans un état où elle peut produire du temps de traitement, mais ne garantit pas la réussite.

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

Voir aussi