Msvm_GuestService::RequestStateChange メソッド

ゲスト サービスの状態を指定した値に変更するように要求します。

構文

uint32 RequestStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob Job,
  [in]  datetime            TimeoutPeriod
);

パラメーター

RequestedState [in]

新しい状態です。 RequestStateChange メソッドのリターン コードが 0 または 4096 の場合、情報はインスタンスの RequestedState プロパティに配置されます。 詳細については、要素の EnabledState プロパティと RequestedState プロパティの説明を参照してください。 これは、次のいずれかの値である必要があります。

有効 (2)

無効 (3)

シャットダウン (4)

オフライン (6)

テスト (7)

Defer (8)

休止 (9)

再起動 (10)

リセット (11)

DMTF 予約済み (..)

ベンダー予約済み (32768..65535)

ジョブ [out]

操作が非同期的に実行された場合に返される CIM_ConcreteJob オブジェクトへの省略可能な参照。 存在する場合、返される参照を使用して進行状況を監視し、 メソッドの結果を取得できます。

TimeoutPeriod [in]

クライアントが新しい状態への移行に要する最大時間を指定するタイムアウト期間。 タイムアウト期間を指定するには、間隔の形式を使用する必要があります。 値 0 または Null は 、クライアントに移行の時間要件がないことを示します。 このプロパティに 0 または Null が含まれていない場合、実装でこのパラメーターがサポートされていない場合は、戻りコード 4098 (サポートされていないタイムアウト パラメーターの使用) を返す必要があります。

戻り値

このメソッドは、次のいずれかの値を返します。

リターン コード/値	説明
エラーなしで完了しました 0	正常終了しました。
サポートされていません 1
チェックされたメソッド パラメーター - 切り替え開始 4096	遷移は非同期です。
タイムアウト パラメーターの使用はサポートされていません 4098
アクセスが拒否されました 32769	アクセスが拒否されました。
この操作の無効な状態 32775	RequestedState パラメーターで指定された値はサポートされていません。

要件

要件	値
サポートされている最小のクライアント	Windows 8.1 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 R2 [デスクトップ アプリのみ]
名前空間	\\Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

こちらもご覧ください

Msvm_GuestService