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 物件。
TargetGroupObjectId [in]
指定目標電腦上的復寫群組目標。
TargetStoragePoolObjectId [in， optional]
要作為建立必要目標儲存元素來源的目標存放集區。 如果目標組包含任何元素，則會忽略此參數。
RecoveryPointObjective [in， optional]
指出數據可能會遺失的最大間隔。 針對同步複製作業， 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 |