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++ 代码示例:设置任务优先级

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mstask.h
Library Mstask.lib
DLL Mstask.dll

另请参阅

GetPriority

ITask