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 メソッドは、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
操作に成功しました。 |
|
引数が無効です。 |
注釈
タスクの優先度を設定した後、 IPersistFile::Save を 呼び出して、変更したタスク オブジェクトをディスクに保存します。
例
タスクの優先度を設定する方法の詳細と例については、「 C/C++ コード例: タスクの優先度の設定」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mstask.h |
Library | Mstask.lib |
[DLL] | Mstask.dll |