RequestReplicationStateChange-Methode der Msvm_ComputerSystem-Klasse

Artikel
06/13/2023

Fordert an, dass der Replikationsstatus des virtuellen Computers in den angegebenen Wert geändert wird und auf die primäre Replikationsbeziehung des virtuellen Computers reagiert. Während der Zustandsänderung wird die ReplicationState-Eigenschaft in den Wert des RequestedState-Parameters geändert. Diese Methode wird nur für Instanzen der Msvm_ComputerSystem-Klasse unterstützt, die einen virtuellen Computer darstellen.

Hinweis

Ab Windows 8.1 wird empfohlen, RequestReplicationStateChange nicht mehr zu verwenden, um eine Änderung des Replikationszustands anzufordern. Verwenden Sie stattdessen RequestReplicationStateChangeEx.

Syntax

uint32 RequestReplicationStateChange(
  [in]  uint16              RequestedState,
  [out] CIM_ConcreteJob REF Job,
  [in]  datetime            TimeoutPeriod
);

Parameter

RequestedState [in]: Der neue Replikationsstatus. Der muss einer der folgenden Werte sein.
Bereit zum Starten der ersten Replikation (1): Bereit zum Starten der ersten Replikation.
Warten auf den Abschluss der ersten Replikation (2): Warten auf den Abschluss der ersten Replikation.
Replizieren (3): Replikation.
Abgeschlossen der synchronisierten Replikation (4): Die synchronisierte Replikation ist abgeschlossen.
Anhalten (7): Anhalten der Replikation.
Abbrechen der erneuten Synchronisierung (9): Abbrechen der erneuten Synchronisierung.

Auftrag [out]

Ein optionaler Verweis auf ein Msvm_ConcreteJob-Objekt , das zurückgegeben wird, wenn der Vorgang asynchron ausgeführt wird. Falls vorhanden, kann der zurückgegebene Verweis verwendet werden, um den Fortschritt zu überwachen und das Ergebnis der Methode zu erhalten.

TimeoutPeriod [in]

Dieser Parameter wird nicht verwendet.

Rückgabewert

Diese Methode gibt einen der folgenden Werte zurück.

Rückgabecode/-wert	BESCHREIBUNG
Abgeschlossen ohne Fehler 0	Erfolgreich
Methodenparameter überprüft – Auftrag gestartet 4096	Der Übergang erfolgt asynchron.
Fehler 32768
Zugriff verweigert 32769
Nicht unterstützt 32770
Der Status ist unbekannt. 32771
Timeout 32772
Ungültiger Parameter 32773	Der in einem der Parameter angegebene Wert wird nicht unterstützt.
Das System wird verwendet. 32774
Ungültiger Status für diesen Vorgang 32775	Der im RequestedState-Parameter angegebene Wert wird im aktuellen Replikationsmodus oder -zustand nicht unterstützt.
Falscher Datentyp 32776
Das System ist nicht verfügbar. 32777
Nicht genügend Arbeitsspeicher 32778
Datei nicht gefunden 32779

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Siehe auch

Msvm_ComputerSystem

Freigeben über