[[此 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 方法返回以下值之一。
| 返回代码 | 说明 | 
|---|---|
| 
 | 操作成功。 | 
| 
 | 参数无效。 | 
注解
设置任务的优先级后,调用 IPersistFile::Save 将修改的任务对象保存到磁盘。
示例
有关详细信息以及如何设置任务优先级的示例,请参阅 C/C++ 代码示例:设置任务优先级。
要求
| 要求 | 值 | 
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] | 
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] | 
| 目标平台 | Windows | 
| 标头 | mstask.h | 
| Library | Mstask.lib | 
| DLL | Mstask.dll |