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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mstask.h
程式庫 Mstask.lib
Dll Mstask.dll

另請參閱

GetPriority

ITask