SetParentVirtualHardDisk-Methode der Msvm _ ImageManagementService-Klasse
Aktualisiert das übergeordnete Element für die angegebenen untergeordneten 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 vollqualifizierten Pfad, der den Speicherort der untergeordneten virtuellen Festplattendatei angibt.
-
ParentPath [ In]
-
Ein vollqualifizierten Pfad, der den Speicherort der übergeordneten virtuellen Festplattendatei angibt.
-
LeafPath [ In]
-
Ein vollqualifizierten Pfad, der den Speicherort der virtuellen Blattfestplattedatei angibt. Der Parameter kann NULL sein, wenn die virtuelle Festplatte offline ist, aber angegeben werden muss, wenn die virtuelle Festplatte verwendet wird.
-
IgnoreIDMismatch [ In]
-
Gibt an, ob das übergeordnete Element 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 _ ConcreteJobabgeleitet wurde.
Rückgabewert
Diese Methode gibt einen der folgenden Werte zurück.
-
Abgeschlossen ohne Fehler (0)
-
Überprüfte Methodenparameter – Auftragsstart (4096)
-
Fehler (32768)
-
Zugriff verweigert (32769)
-
Nicht unterstützt (32770)
-
Status ist unbekannt (32771)
-
Timeout (32772)
-
Ungültiger Parameter (32773)
-
System wird verwendet (32774)
-
Ungültiger Zustand für diesen Vorgang (32775)
-
Falscher Datentyp (32776)
-
System ist nicht verfügbar (32777)
-
Nicht genügend Arbeitsspeicher (32778)
-
Datei nicht gefunden (32779)
Hinweise
Mit dieser Methode können nur die folgenden Arten von virtuellen Festplatten verwendet werden:
- Differenzierende VHD
- Differenzierende VHDX
Der Zugriff auf die Msvm _ ImageManagementService-Klasse kann durch die 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 |
|