ICLRTask::YieldTask (Método)

Artículo
08/10/2011

Solicita que Common Language Runtime (CLR) aparte la tarea representada por la instancia actual de ICLRTask y ponga tiempo de procesador a disposición de otras tareas.

HRESULT YieldTask ();

Valor devuelto

HRESULT	Descripción
S_OK	YieldTask finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Si un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

Un host llama a YieldTask para solicitar recursos del procesador para otras tareas o procesos. Este método está pensado principalmente para permitir al código de ejecución prolongada ceder tiempo de CPU. Aunque el motor en tiempo de ejecución intenta situar la tarea que representa la instancia de ICLRTask actual en un estado en el que pueda ceder tiempo de procesamiento, no existe ninguna garantía de que pueda lograrlo.