ICLRTask::YieldTask (Método)
Solicita que Common Language Runtime (CLR) deje de lado la tarea que representa la instancia de ICLRTask actual y ponga el tiempo del procesador a disposición de otras tareas.
Sintaxis
HRESULT YieldTask ();
Valor devuelto
HRESULT | Descripción |
---|---|
S_OK | YieldTask se devolvió correctamente. |
HOST_E_CLRNOTAVAILABLE | Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente. |
HOST_E_TIMEOUT | Se agotó el tiempo de espera de la llamada. |
HOST_E_NOT_OWNER | El autor de la llamada no es el propietario del bloqueo. |
HOST_E_ABANDONED | Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando. |
E_FAIL | Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE. |
Comentarios
Un host llama a YieldTask
a fin de solicitar recursos de procesador para otras tareas o procesos. Este método está pensado principalmente para permitir que el código de ejecución prolongada libere tiempo de CPU. El runtime intenta colocar la tarea que representa la instancia de ICLRTask
actual en un estado en el que pueda producir tiempo de procesamiento, pero no garantiza que está operación se realice correctamente.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: MSCorEE.h
Biblioteca: incluida como recurso en MSCorEE.dll
Versiones de .NET Framework: disponible a partir de la versión 2.0