次の方法で共有

Msvm_GuestServiceInterfaceComponent::RequestStateChange メソッド

  • [アーティクル]

ゲスト サービス インターフェイス コンポーネントの状態を指定した値に変更するように要求します。

構文

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

パラメーター

RequestedState [in]

型: uint16

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

有効 (2)

無効 (3)

シャットダウン (4)

オフライン (6)

テスト (7)

延期 (8)

休止 (9)

再起動 (10)

リセット (11)

DMTF 予約済み (...)

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

ジョブ [出力]

種類: CIM_ConcreteJob

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

TimeoutPeriod [in]

種類: datetime

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

戻り値

型: uint32

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

リターン コード/値 説明
エラーなしで完了
0
 正常終了しました。
サポートされていません
1
不明/未指定のエラー
2
タイムアウト期間内に完了できません
3
Failed
4
無効なパラメーター
5
使用中
6
DMTF 予約済み
..
チェックされたメソッド パラメーター - 切り替えが開始されました
4096
無効な状態遷移
4097
タイムアウト パラメーターの使用はサポートされていません
4098
忙しい
4099
メソッド予約済み
4100..32767
ベンダー固有
32768..65535

要件

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

こちらもご覧ください

Msvm_GuestServiceInterfaceComponent