Метод 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
