MSFT_VirtualDisk クラスの CreateReplica メソッド

仮想ディスク間のレプリケーション関係を作成します。

構文

UInt32 CreateReplica(
  [in]  String              FriendlyName,
  [in]  String              TargetStorageSubsystem,
  [in]  String              TargetVirtualDiskObjectId,
  [in]  String              TargetStoragePoolObjectId,
  [in]  UInt16              RecoveryPointObjective,
  [in]  String              ReplicationSettings,
  [in]  UInt16              SyncType,
  [out] String              CreatedReplicaPeer,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              ExtendedStatus
);

パラメーター

FriendlyName [in]

作成される要素のエンド ユーザー関連の名前。 NULL の場合、システム指定の既定の名前を使用できます。

TargetStorageSubsystem [in]

レプリカ ターゲット マシンを指定する埋め込み MSFT_ReplicaPeer オブジェクトを含む文字列。

TargetVirtualDiskObjectId [in]

ターゲット マシン上の仮想ディスク ターゲットを指定します。

TargetStoragePoolObjectId [in]

ターゲット仮想ディスクを作成するためのソースとして使用されるターゲット上のストレージ プール。 ターゲット仮想ディスクが指定された場合、このパラメーターは無視されます。

RecoveryPointObjective [in]

データが失われる可能性がある最大間隔を示します。 同期コピー操作の場合、 RecoveryPointObjective は 0 です。 非同期コピー操作の場合、RecoveryPointObjective は、データがターゲット要素へ最後に転送されてからの間隔を表します。

ReplicationSettings [in]

適用する埋め込み MSFT_ReplicationSettings オブジェクトを含む文字列。

SyncType [in]

作成されるコピーの種類。 次のいずれかの値です。

Value	意味
DMTF 予約済み ..	この値は、システム使用のために予約されています。
Mirror 6	ソースのコピーを作成して維持します。
Snapshot 7	ソースのボリューム シャドウ コピーを作成します。
Clone 8	ソースのポイントインタイムで完全なコピーを作成します。
TokenizedClone 9	ソースのポイントインタイムでトークン化したコピーを作成します。
DMTF 予約済み ..	この値は、システム使用のために予約されています。
Vendor Specific 0x8000..	これらの値はベンダー向けに予約されています。

CreatedReplicaPeer [out]

リレーションシップが正常に作成されると、このパラメーターは、ターゲットのレプリカ ピアを表す埋め込み MSFT_ReplicaPeer オブジェクトを含む文字列を受け取ります。

CreatedStorageJob [out]

実行時間の長い操作を追跡するために使用されるストレージ ジョブ オブジェクトへの参照を返します。

ExtendedStatus [out]

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

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

戻り値

成功 (0)

サポートされていません (1)

不明なエラー (2)

タイムアウト (3)

失敗 (4)

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

オブジェクトが見つかりません (8)

メソッド パラメーターチェック済み - ジョブが開始されました (4096)

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

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

キャッシュの期限切れ (40003)

クラスターのアップグレード中の操作はサポートされていません。 (40009)

要件

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

関連項目

MSFT_VirtualDisk