Метод ICLRTask::YieldTask
Запрашивает временную приостановку средой CLR выполнения задачи, представленной данным экземпляром ICLRTask, и предоставление процессорного времени для других задач.
HRESULT YieldTask ();
Возвращаемое значение
HRESULT |
Описание |
|---|---|
S_OK |
Метод YieldTask успешно возвратил значение. |
HOST_E_CLRNOTAVAILABLE |
Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов. |
HOST_E_TIMEOUT |
Время ожидания вызова истекло. |
HOST_E_NOT_OWNER |
Вызывающий объект не владеет блокировкой. |
HOST_E_ABANDONED |
Событие, которого ожидал заблокированный поток или нить, было отменено. |
E_FAIL |
Произошел неизвестный разрушительный сбой. Если метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE. |
Заметки
Основное приложение вызывает метод YieldTask с целью запроса ресурсов процессора для выполнения других задач или процессов. Этот метод предназначен преимущественно для обеспечения возможности освобождения времени ЦП долго выполняющимся кодом. Среда выполнения пытается перевести задачу, представленную данным экземпляром ICLRTask, в состояние, в котором она сможет выделить время обработки, однако не дает никаких гарантий успешного выполнения.
Требования
Платформы: см. раздел Требования к системе для .NET Framework.
Заголовок: MSCorEE.h
Библиотека: включена как ресурс в MSCorEE.dll
Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0