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


Метод ITaskSettings::p ut_Priority (taskschd.h)

Возвращает или задает уровень приоритета задачи.

Это свойство является чтением и записью.

Синтаксис

HRESULT put_Priority(
  int priority
);

Параметры

priority

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

None

Remarks

Уровень приоритета 0 — это наивысший приоритет, а уровень приоритета 10 — самый низкий. По умолчанию используется значение 7. Уровни приоритета 7 и 8 используются для фоновых задач, а уровни приоритета 4, 5 и 6 — для интерактивных задач.

Действие задачи запускается в процессе с приоритетом, основанным на значении Класса приоритета. Значение уровня приоритета (приоритет потока) используется для действий обработчика COM, окна сообщения и задачи электронной почты. Дополнительные сведения о значениях класса приоритета и уровня приоритета см. в разделе Планирование приоритетов. Это значение также влияет на приоритет памяти (см . MEMORY_PRIORITY_INFORMATION). В следующей таблице перечислены возможные значения параметра priority , а также соответствующие значения класса приоритета и уровня приоритета.

Приоритет задачи Класс Priority Уровень приоритета
0 REALTIME_PRIORITY_CLASS THREAD_PRIORITY_TIME_CRITICAL
1 HIGH_PRIORITY_CLASS THREAD_PRIORITY_HIGHEST
2 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
3 ABOVE_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_ABOVE_NORMAL
4 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
5 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
6 NORMAL_PRIORITY_CLASS THREAD_PRIORITY_NORMAL
7 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
8 BELOW_NORMAL_PRIORITY_CLASS THREAD_PRIORITY_BELOW_NORMAL
9 IDLE_PRIORITY_CLASS THREAD_PRIORITY_LOWEST
10 IDLE_PRIORITY_CLASS THREAD_PRIORITY_IDLE
  Приоритет задачи 4 соответствует приоритету памяти "MEMORY_PRIORITY_NORMAL(5)", от 5 до "MEMORY_PRIORITY_BELOW_NORMAL(4)" и с 6 до "MEMORY_PRIORITY_MEDIUM(3)".

При чтении или записи XML для задачи этот параметр указывается в элементе Priority (settingsType) схемы планировщика задач.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header taskschd.h
Библиотека Taskschd.lib
DLL Taskschd.dll

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

ITaskSettings