CreateReplica-Methode der MSFT_VirtualDisk-Klasse
Erstellt eine Replikationsbeziehung zwischen virtuellen Datenträgern.
Syntax
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
);
Parameter
FriendlyName [in]
Ein endbenutzerrelevanter Name für das zu erstellende Element. Wenn NULL, kann ein vom System bereitgestellter Standardname verwendet werden.
TargetStorageSubsystem [in]
Eine Zeichenfolge, die ein eingebettetes MSFT_ReplicaPeer Objekt enthält, das den Replikatzielcomputer angibt.
TargetVirtualDiskObjectId [in]
Gibt das Ziel des virtuellen Datenträgers auf dem Zielcomputer an.
TargetStoragePoolObjectId [in]
Ein Speicherpool für das Ziel, das als Quelle zum Erstellen des virtuellen Zieldatenträgers verwendet werden soll. Dieser Parameter wird ignoriert, wenn ein virtueller Zieldatenträger angegeben wird.
RecoveryPointObjective [in]
Gibt das maximale Intervall an, in dem Daten verloren gehen können. Bei synchronen Kopiervorgängen ist RecoveryPointObjective 0. Für asynchrone Kopiervorgänge stellt RecoveryPointObjective das Intervall seit der letzten Übertragung von Daten an das Zielelement dar.
ReplicationSettings [in]
Eine Zeichenfolge, die ein eingebettetes MSFT_ReplicationSettings objekt enthält, das angewendet werden soll.
SyncType [in]
Der Typ der Kopie, die erstellt wird. Einer der folgenden Werte:
| Wert | Bedeutung |
|---|---|
| DMTF Reserved .. | Dieser Wert ist für die Systemnutzung reserviert. |
| Spiegel 6 | Erstellen und Verwalten einer Kopie der Quelle. |
| Momentaufnahme 7 | Erstellen Sie eine Volumeschattenkopie der Quelle. |
| Klonen 8 | Erstellen Sie eine Point-in-Time-Kopie der Quelle. |
| TokenizedClone 9 | Erstellen Sie eine punktinterne, tokenisierte Kopie der Quelle. |
| DMTF Reserved .. | Dieser Wert ist für die Systemnutzung reserviert. |
| Anbieterspezifische 0x8000.. | Diese Werte sind für Anbieter reserviert. |
CreatedReplicaPeer [out]
Wenn die Beziehung erfolgreich erstellt wird, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_ReplicaPeer Objekt enthält, das den Replikatspeer für das Ziel darstellt.
CreatedStorageJob [out]
Gibt einen Verweis auf das Speicher-Job-Objekt zurück, das zum Verfolgen des langlaufenden Vorgangs verwendet wird.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus-Objekt enthält.
Dieser Parameter bietet dem Speicheranbieter die Möglichkeit, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
Rückgabewert
Success (0)
Nicht unterstützt (1)
Unspezifischer Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Objekt nicht gefunden (8)
Methodenparameter überprüft – Job gestartet (4096)
Zugriff verweigert (40001)
Es stehen nicht genügend Ressourcen zur Verfügung, um den Vorgang abzuschließen. (40002)
Veraltetes Cache (40003)
Der Vorgang wird nicht unterstützt, während der Cluster aktualisiert wird. (40009)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| Header | Adojet.h |
| MOF | Storagewmi.mof |