SetParentVirtualHardDisk-Methode der Msvm_ImageManagementService-Klasse
Updates das übergeordnete Element für die angegebenen blatt- und untergeordneten virtuellen Festplattendateien. Informationen zu Verwendungseinschränkungen für diese Methode finden Sie unter Hinweise.
Syntax
uint32 SetParentVirtualHardDisk(
[in] string ChildPath,
[in] string ParentPath,
[in] string LeafPath,
[in] boolean IgnoreIDMismatch,
[out] CIM_ConcreteJob REF Job
);
Parameter
-
ChildPath [in]
-
Ein vollqualifizierter Pfad, der den Speicherort der untergeordneten virtuellen Festplattendatei angibt.
-
ParentPath [in]
-
Ein vollqualifizierter Pfad, der den Speicherort der übergeordneten virtuellen Festplattendatei angibt.
-
LeafPath [in]
-
Ein vollqualifizierter Pfad, der den Speicherort der untergeordneten virtuellen Festplattendatei angibt. Der Parameter kann NULL sein, wenn die virtuelle Festplatte offline ist, muss aber angegeben werden, wenn die virtuelle Festplatte verwendet wird.
-
IgnoreIDMismatch [in]
-
Gibt an, ob das übergeordnete Element zwangsweise festgelegt werden soll, wenn die Bezeichner des virtuellen Datenträgers nicht übereinstimmen. Dieser Parameter muss mit Vorsicht verwendet werden, da datenbeschädigungen auftreten können, wenn die neue übergeordnete virtuelle Festplatte nicht mit der ursprünglichen übergeordneten Festplatte identisch ist.
-
Auftrag [out]
-
Wenn der Vorgang asynchron ausgeführt wird, gibt diese Methode 4096 zurück, und dieser Parameter enthält einen Verweis auf ein Objekt, das von CIM_ConcreteJob abgeleitet wurde.
Rückgabewert
Diese Methode gibt einen der folgenden Werte zurück.
-
Abgeschlossen ohne Fehler (0)
-
Methodenparameter überprüft – Auftrag gestartet (4096)
-
Fehler (32768)
-
Zugriff verweigert (32769)
-
Nicht unterstützt (32770)
-
Status ist unbekannt (32771)
-
Timeout (32772)
-
Ungültiger Parameter (32773)
-
Das System wird verwendet (32774)
-
Ungültiger Status für diesen Vorgang (32775)
-
Falscher Datentyp (32776)
-
System ist nicht verfügbar (32777)
-
Nicht genügend Arbeitsspeicher (32778)
-
Datei nicht gefunden (32779)
Bemerkungen
Mit dieser Methode können nur die folgenden Typen von virtuellen Festplatten verwendet werden:
- Differenzierende VHD
- Differenzierende VHDX
Der Zugriff auf die Msvm_ImageManagementService-Klasse kann durch UAC-Filterung eingeschränkt werden. Weitere Informationen finden Sie unter Benutzerkontensteuerung und WMI.
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 |
|
| DLL |
|