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 |