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