Msvm_ComputerSystem クラスの RequestReplicationStateChange メソッド

仮想マシンのレプリケーション状態を指定した値に変更し、仮想マシンのプライマリ レプリケーション関係に対して動作するように要求します。 状態の変更が進行中に、 ReplicationState プロパティが RequestedState パラメーターの値に変更されます。 このメソッドは、仮想マシンを表す Msvm_ComputerSystem クラスのインスタンスでのみサポートされます。

注意

Windows 8.1以降では、レプリケーション状態の変更を要求するために RequestReplicationStateChange を使用しないことをお勧めします。 代わりに、 RequestReplicationStateChangeEx を使用します。

構文

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

パラメーター

RequestedState [in]

新しいレプリケーションの状態。 は、次のいずれかの値である必要があります。

初期レプリケーションを開始する準備ができました (1)

初期レプリケーションを開始する準備ができました。

初期レプリケーションの完了を待機 しています (2)

初期レプリケーションの完了を待機しています。

レプリケート ( 3)

レプリケーション中。

同期されたレプリケーションの完了 (4)

同期されたレプリケーションが完了しました。

中断 (7)

レプリケーションを中断します。

再同期の取り消し (9)

再同期を取り消します。

ジョブ [out]

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

TimeoutPeriod [in]

このパラメーターは使用されません。

戻り値

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

リターン コード/値	説明
エラーなしで完了しました 0	成功
メソッド パラメーターのチェック - ジョブの開始 4096	遷移は非同期です。
失敗 32768
アクセスが拒否されました 32769
サポートされていません 32770
状態が不明です 32771
タイムアウト 32772
パラメーターが無効です 32773	パラメーターの 1 つで指定された値はサポートされていません。
システムが使用中です 32774
この操作の無効な状態 32775	RequestedState パラメーターで指定された値は、現在のレプリケーション モードまたは状態ではサポートされていません。
データ型が正しくありません 32776
システムは使用できません 32777
メモリ不足 32778
ファイルが見つかりません 32779

必要条件

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

関連項目

Msvm_ComputerSystem