MSFT_ReplicationGroup 类的 CreateReplica 方法

在复制组之间创建复制关系。

语法

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

参数

FriendlyName [in]

正在创建的元素的最终用户相关名称。 如果 为 NULL,则可以使用系统提供的默认名称。 该值将存储在所创建元素的 FriendlyName 属性中。

TargetStorageSubsystem [in]

一个字符串,其中包含一个嵌入式MSFT_ReplicaPeer对象,该对象指定副本 (replica) 目标子系统。

TargetGroupObjectId [in]

指定目标计算机上的复制组目标。

TargetStoragePoolObjectId [in, optional]

目标上的存储池,用作创建必要目标存储元素的源。 如果目标组包含任何元素,则忽略此参数。

RecoveryPointObjective [in, 可选]

指示数据可能丢失的最大间隔。 对于同步复制操作, RecoveryPointObjective 为 0。 对于异步复制操作 ,RecoveryPointObjective 表示自最近将数据传输到目标元素以来的间隔。

ReplicationSettings [in]

包含要应用的嵌入 MSFT_ReplicationSettings 对象的字符串。

SyncType [in]

将要创建的副本类型。 以下值之一:

“值” 含义
DMTF 保留 。 该值已预留供系统使用。
镜像 6 创建和维护源的副本。
快照 7 创建源的卷影副本。
克隆 8 创建源的时间点完整副本。
TokenizedClone 9 创建源的时间点标记化副本。
DMTF 保留 。 该值已预留供系统使用。
供应商特定 0x8000。 这些值是为供应商保留的。

CreatedReplicaPeer [out]

此参数接收一个字符串,其中包含表示复制组之间的关联的嵌入 MSFT_Synchronized 对象。

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_ReplicationGroup