Метод ITask::SetPriority (mstask.h)

  • Статья

[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]

Этот метод задает приоритет для задачи.

Синтаксис

HRESULT SetPriority(
  [in] DWORD dwPriority
);

Параметры

[in] dwPriority

Значение DWORD, указывающее приоритет для текущей задачи. Приоритет задачи определяет частоту и продолжительность временных срезов для процесса. Это относится только к операционным системам Windows Server 2003, Windows XP и Windows 2000. Эти значения взяты из класса приоритета CreateProcess и могут иметь один из следующих флагов (в порядке убывания приоритета планирования потоков):

  • REALTIME_PRIORITY_CLASS
  • HIGH_PRIORITY_CLASS
  • NORMAL_PRIORITY_CLASS
  • IDLE_PRIORITY_CLASS

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

Метод SetPriority возвращает одно из следующих значений.

Код возврата Описание
S_OK
 Операция выполнена успешно.
E_INVALIDARG
 Недопустимые аргументы.

Комментарии

Задав приоритет задачи, вызовите IPersistFile::Save , чтобы сохранить измененный объект задачи на диске.

Примеры

Дополнительные сведения и пример установки приоритета задачи см. в разделе C/C++ Code Example: Setting Task Priority.

Требования

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

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

GetPriority

ITask