MSFT_StorageJob クラスの RequestStateChange メソッド

ジョブの状態を RequestedState パラメーターで指定された値に変更するように要求します。

構文

UInt32 RequestStateChange(
  [in]  UInt16 RequestedState,
  [out] String ExtendedStatus
);

パラメーター

RequestedState [in]

新しい状態です。

Value	意味
開始 2	この値は、JobState プロパティの値を実行中に変更します。
中断 3	この値は、ジョブを一時的に停止します。 その後、RequestedState パラメーターを開始に設定して RequestStateChange の 2 回目の呼び出しでジョブを再起動します。 ジョブが中断中にサービス状態になる可能性があります。 (これはジョブ固有です。)
終了 4	この値は、ジョブを完全に停止し、データを保存します。また、状態を保持し、基になるすべてのプロセスを順番にシャットダウンします。
中止 5	この値は、データを保存したり状態を保持したりする要件がなく、ジョブを直ちに終了します。
サービス 6	この値により、ジョブはベンダー固有のサービス状態になります。 ジョブを再起動できる場合があります。
DMTF 予約済み 7..32767	7 ~ 32767 (境界値を含む) の値は DMTF 用に予約されています。
ベンダー予約済み 32768..65535	32768 ~ 65535 (境界値を含む) の値は、ベンダー向けに予約されています。

ExtendedStatus [out]

埋め込み MSFT_StorageExtendedStatus オブジェクトを含む文字列。

このパラメーターを使用すると、ストレージ プロバイダーは拡張 (実装固有) エラー情報を返すことができます。

戻り値

成功 (0)

サポート非対称 (1)

不明なエラー (2)

タイムアウト (3)

失敗 (4)

無効なパラメーター (5)

チェックされたメソッド パラメーター - ジョブの開始 (4096)

サイズがサポートされていません (4097)

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

リソース不足のため、操作を完了できません。 (40002)

ストレージ プロバイダーに接続できません。 (46000)

ストレージ プロバイダーがストレージ サブシステムに接続できません。 (46001)

解説

このメソッドを複数回呼び出すと、以前の要求が上書きされたり失われたりする可能性があります。

要件

要件	Value
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
名前空間	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

関連項目

MSFT_StorageJob