ITaskSettings::p ut_Priority メソッド (taskschd.h)
タスクの優先度レベルを取得または設定します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT put_Priority(
int priority
);
パラメーター
priority
戻り値
なし
解説
優先度レベル 0 が最も高く、優先度レベル 10 が最も低い優先度です。 既定値は 7 です。 優先度レベル 7 と 8 はバックグラウンド タスクに使用され、優先度レベル 4、5、および 6 は対話型タスクに使用されます。
タスクのアクションは、優先度クラスの値に基づく優先度を持つプロセスで開始されます。 優先度レベルの値 (スレッドの優先度) は、COM ハンドラー、メッセージ ボックス、および電子メール タスクアクションに使用されます。 優先度クラスと優先度レベルの値の詳細については、「 スケジュールの優先順位」を参照してください。 この値は、メモリの優先度にも影響します ( MEMORY_PRIORITY_INFORMATIONを参照)。 次の表に、 priority パラメーターに指定できる値と、対応する Priority クラスと優先度レベルの値を示します。
| タスク の優先度 | Priority クラス | 優先度レベル |
|---|---|---|
| 0 | REALTIME_PRIORITY_CLASS | THREAD_PRIORITY_TIME_CRITICAL |
| 1 | HIGH_PRIORITY_CLASS | THREAD_PRIORITY_HIGHEST |
| 2 | ABOVE_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_ABOVE_NORMAL |
| 3 | ABOVE_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_ABOVE_NORMAL |
| 4 | NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_NORMAL |
| 5 | NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_NORMAL |
| 6 | NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_NORMAL |
| 7 | BELOW_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_BELOW_NORMAL |
| 8 | BELOW_NORMAL_PRIORITY_CLASS | THREAD_PRIORITY_BELOW_NORMAL |
| 9 | IDLE_PRIORITY_CLASS | THREAD_PRIORITY_LOWEST |
| 10 | IDLE_PRIORITY_CLASS | THREAD_PRIORITY_IDLE |
タスクの XML の読み取りまたは書き込み時に、この設定はタスク スケジューラ スキーマの Priority (settingsType) 要素で指定されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | taskschd.h |
| Library | Taskschd.lib |
| [DLL] | Taskschd.dll |