Поделиться через

Метод IHostTask::SetPriority

Запрашивает, чтобы узел отрегулировал уровень приоритета потока для задачи, представленной текущим экземпляром IHostTask .

Синтаксис

HRESULT SetPriority (  
    [in] int newPriority  
);

Параметры

newPriority
[in] Целое число, представляющее запрошенное значение приоритета потока для задачи, представленной текущим IHostTask экземпляром.

Возвращаемое значение

HRESULT Описание:
S_OK SetPriority возвращается успешно.
HOST_E_CLRNOTAVAILABLE Среда CLR не была загружена в процесс или среда CLR находится в состоянии, в котором она не может выполнить управляемый код или обработать вызов.
HOST_E_TIMEOUT Истекло время ожидания звонка.
HOST_E_NOT_OWNER Вызывающий объект не является владельцем блокировки.
HOST_E_ABANDONED Событие было отменено во время ожидания заблокированного потока или волокна.
E_FAIL Произошла неизвестная катастрофическая ошибка. Когда метод возвращает E_FAIL, среда CLR больше не поддерживается в процессе. Последующие вызовы методов размещения возвращают HOST_E_CLRNOTAVAILABLE.

Комментарии

Потокам предоставляется время обработки с помощью системы циклического перебора, которая частично основана на уровне приоритета потока. SetPriority позволяет среде CLR задать этот уровень приоритета потока для текущей задачи. Поддерживаются следующие newPriority значения.

  • THREAD_PRIORITY_ABOVE_NORMAL

  • THREAD_PRIORITY_BELOW_NORMAL

  • THREAD_PRIORITY_HIGHEST

  • THREAD_PRIORITY_IDLE

  • THREAD_PRIORITY_LOWEST

  • THREAD_PRIORITY_NORMAL

  • THREAD_PRIORITY_TIME_CRITICAL

Среда CLR вызывает SetPriority , когда значение Thread.Priority объекта изменяется пользовательским кодом. Узел может определять собственные алгоритмы для назначения приоритета потока и может игнорировать этот запрос.

Примечание

SetPriority не сообщает, был ли изменен уровень приоритета потока. Вызовите метод IHostTask::GetPriority , чтобы определить значение уровня приоритета потока задачи.

Значения уровня приоритета потока определяются функцией Win32 SetThreadPriority . Дополнительные сведения о приоритете потоков см. в документации по платформе Windows.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

Библиотека: Включено в качестве ресурса в MSCorEE.dll

версии платформа .NET Framework: доступно с версии 2.0

См. также раздел

  • Last updated on