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

Статья
08/26/2023

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

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

Синтаксис

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

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