CIM_ConcreteJob クラスの RequestStateChange メソッド
ジョブの状態を RequestedState パラメーターで指定された値に変更するように要求します。 RequestStateChange メソッドを複数回呼び出すと、以前の要求が上書きされたり失われたりする可能性があります。
0 が返された場合、タスクは正常に完了しました。 その他の戻りコードは、エラー状態を示します。
構文
uint32 RequestStateChange(
[in] uint16 RequestedState,
[in] datetime TimeoutPeriod
);
パラメーター
-
RequestedState [in]
-
ジョブに対して要求する状態。 次のような値が考えられます。
-
開始 (2)
-
状態を "実行中" に変更します。
-
中断 (3)
-
ジョブを一時的に停止します。 その後、"開始" を使用してジョブを再起動することが目的です。 中断中に "サービス" 状態に入る可能性があります。 (これはジョブ固有です)。
-
Terminate (4)
-
ジョブをクリーンに停止し、データを保存し、状態を保持し、基になるすべてのプロセスを順番にシャットダウンします。
-
Kill (5)
-
データを保存したり、状態を保持したりする必要なく、ジョブを直ちに終了します。
-
サービス (6)
-
ジョブをベンダー固有のサービス状態にします。 ジョブを再起動できる場合があります。
-
DMTF 予約済み (7..32767)
-
ベンダー予約済み (32768..65535)
TimeoutPeriod [in]
クライアントが新しい状態への移行にかかる最大時間を指定するタイムアウト期間。 タイムアウト期間を指定するには、間隔形式を使用する必要があります。 0 または Null の 値は、クライアントに移行の時間要件がないことを示します。 このプロパティに 0 または Null が含まれていない場合、実装でこのパラメーターがサポートされていない場合は、戻りコード 4098 (サポートされていないタイムアウト パラメーターの使用) を返す必要があります。
戻り値
成功した場合は 0 を返します。それ以外の場合は、エラーを返します。
-
エラーなしで完了 しました (0)
-
サポートされていません (1)
-
不明/未指定のエラー (2)
-
タイムアウト期間内に完了できません (3)
-
失敗 ( 4)
-
無効なパラメーター (5)
-
使用中 (6)
-
DMTF 予約済み (...)
-
チェックされたメソッド パラメーター - 切り替えが開始 されました (4096)
-
無効な状態遷移 (4097)
-
タイムアウト パラメーターの使用はサポートされていません (4098)
-
Busy (4099)
-
メソッド予約済み (4100..32767)
-
ベンダー固有 (32768..65535)
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 8.1 |
| サポートされている最小のサーバー |
Windows Server 2012 R2 |
| 名前空間 |
Root\virtualization\v2 |
| MOF |
|
| [DLL] |
|