Share via

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