Win32_Process クラスの SetPriority メソッド

SetPriorityWMI クラス メソッドは、プロセスの実行優先度の変更を試みます。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 SetPriority(
  [in] sint32 Priority
);

パラメーター

優先度 [入力]

プロセスの新しい優先度クラス。 これらの値は、Win32_Process の Priority プロパティに明示的に示されているものとは異なります。

アイドル ( 64)

システムがアイドル状態の場合にのみ実行されるスレッドを含むプロセスに対して指定されます。 プロセスのスレッドは、優先順位の高いクラス (スクリーン セーバーなど) で実行されるプロセスのスレッドによって割り込まれます。 アイドル優先度クラスは、子プロセスによって継承されます。

標準より下 (16384)

IDLE_PRIORITY_CLASSより優先度が高いが、NORMAL_PRIORITY_CLASS未満のプロセスを示します。

標準 (32)

特別なスケジュール設定を必要としないプロセスに対して指定されます。

標準より上 (32768)

NORMAL_PRIORITY_CLASSより優先度が高いが、HIGH_PRIORITY_CLASS未満のプロセスを示します。

高優先度 (128)

即時に実行する必要があるタイム クリティカルなタスクを実行するプロセスに対して指定します。 このプロセスのスレッドは、Normal または Idle 優先順位クラスのプロセスのスレッドよりも優先します。 たとえば、タスク リストは、オペレーティング システムの負荷に関係なく、ユーザーが呼び出したときに迅速に応答する必要があります。 優先度の高いクラス アプリケーションでは使用可能なすべての CPU 時間を使用できるため、優先度の高いクラスを使用する場合は細心の注意を払います。

リアルタイム (256)

可能な限り高い優先度を持つプロセスに対して指定されます。 プロセスのスレッドは、重要なタスクを実行するオペレーティング システム プロセスなど、他のすべてのプロセスのスレッドを優先します。 たとえば、非常に短い間隔を超えて実行されるリアルタイム プロセスでは、ディスク キャッシュがフラッシュされないか、マウスが応答しなくなる可能性があります。

戻り値

次の一覧に記載されている値の 1 つ、またはエラーを示す別の値を返します。 その他のエラー コードについては、「 WMI エラー定数」 または 「WbemErrorEnum」を参照してください。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

正常に完了しました (0)

アクセスが拒否されました (2)

特権が不十分 (3)

不明なエラー (8)

パスが見つかりません (9)

パラメーターが無効です (21)

その他 (22 4294967295)

注釈

優先度を Realtime に設定するには、呼び出し元に SeIncreaseBasePriorityPrivilege (SE_INC_BASE_PRIORITY_PRIVILEGE) が必要です。 この特権がないと、優先度が最も高い を [高優先度] に設定できます。

例

実行中のプロセスの優先度の変更 VBScript サンプルでは、Notepad.exeの実行中のインスタンスの優先度を Normal から Above Normal に変更します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

オペレーティング システム クラス

Win32_Process