IVMVirtualPC::CreateDifferencingVirtualHardDisk-Methode
[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung verfügbar. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]
Erstellt eine differenzierende virtuelle Festplatte.
Syntax
HRESULT CreateDifferencingVirtualHardDisk(
[in] BSTR imagePath,
[in] BSTR parentPath,
[out, retval] IVMTask **diskTask
);
Parameter
-
imagePath [ In]
-
Der Pfad zur neuen Datenträgerimagedatei. Der enthaltende Ordner wird erstellt, wenn er nicht vorhanden ist.
-
parentPath [ In]
-
Der Pfad zur übergeordneten Datenträgerimagedatei.
-
diskTask [ out, retval]
-
Ein IVMTask-Objekt, das zum Nachverfolgen der Imageerstellung verwendet wird.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Ein Parameter ist NULL. |
|
Das System kann den durch den imagePath- oder parentPath-Parameter angegebenen Pfad nicht finden. |
|
Die durch den imagePath-Parameter angegebene Datei befindet sich auf einer CD-ROM oder DVD-ROM. |
|
Der imagePath- oder parentPath-Parameter enthält ein ungültiges Zeichen (eines von " * ?:<>/ | ""). |
|
Sowohl der imagePath-Parameter als auch der parentPath-Parameter geben einen leeren oder relativen Pfad an. Mindestens einer der Parameter muss ein absoluter Pfad sein. |
|
Der durch die parameter imagePath oder parentPath angegebene Pfad ist zu lang. Die Länge des Pfads muss kleiner als 260 Zeichen sein. |
|
Die Datei, auf die vom imagePath-Parameter verwiesen wird, ist bereits vorhanden. |
|
Das dynamisch erweiterbare virtuelle Festplattenimage benötigt mindestens 8 MB freien Speicherplatz auf dem Hostvolume. |
|
Die Parametergröße muss kleiner als 2.088.960 MB sein. Wenn das Format FAT16 ist, muss die Größe kleiner als 2.000 MB sein. |
|
Unformatierte und FAT16-formatierte virtuelle Festplattenimages müssen mindestens 3 MB groß sein. Fat32-formatierte virtuelle Festplattenimages müssen mindestens 514 MB groß sein. |
|
Das Hostvolume kann eine Datei dieser Größe nicht unterstützen, wenn das dynamisch erweiterbare image der virtuellen Festplatte bis zum vollständigen Grenzwert erweitert wird. Die maximale Dateigröße für ein FAT32-Volume beträgt 4 GB. Die maximale Dateigröße für ein FAT16-Volume beträgt 2 GB. |
|
Die virtuelle Festplatte kann nicht erstellt werden, nachdem das Herunterfahren der Anwendung gestartet wurde. |
|
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization). |
|
Ein unerwarteter Fehler ist aufgetreten. |
Hinweise
Obwohl imagePath oder parentPath ein relativer Pfad sein kann, muss mindestens einer davon ein absoluter Pfad sein. Wenn ein Pfadparameter ein relativer Pfad ist, wird davon ausgegangen, dass er relativ zum anderen Pfadparameter ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
nur Windows 7 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Ende des Supports (Client) |
Windows 7 |
| Product (Produkt) |
Windows Virtual PC |
| Header |
|
| IID |
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert. |