IVMVirtualPC::CreateFixedVirtualHardDisk-Methode
[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]
Erstellt eine virtuelle Festplatte mit fester Größe.
Syntax
HRESULT CreateFixedVirtualHardDisk(
[in] BSTR imagePath,
[in] long size,
[out, retval] IVMTask **diskTask
);
Parameter
-
imagePath [ In]
-
Der vollständige Pfad zur neuen Datenträgerimagedatei. Der enthaltende Ordner wird erstellt, wenn er nicht vorhanden ist.
-
size [ In]
-
Die Größe des Bilds in Megabyte. Die maximale Größe beträgt 2.088.960 MB (2040 GB).
-
diskTask [ out, retval]
-
Ein IVMTask-Objekt, das zum Nachverfolgen der Erstellung des Images 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. |
|
Der size-Parameter ist kleiner oder gleich 0. |
|
Das System kann den durch den imagePath-Parameter angegebenen Pfad nicht finden. |
|
Die durch den imagePath-Parameter angegebene Datei befindet sich auf einer CD-ROM oder DVD-ROM. |
|
Der imagePath-Parameter enthält ein ungültiges Zeichen (eines von " * ?:<>/ | ""). |
|
Der imagePath-Parameter gibt einen leeren oder relativen Pfad an. Mindestens einer der Parameter muss ein absoluter Pfad sein. |
|
Der durch den imagePath-Parameter angegebene Pfad ist zu lang. Die Länge des Pfads muss kleiner als MAX _ PATH (260) Zeichen sein. |
|
Die Datei, auf die der imagePath-Parameter verweist, ist bereits vorhanden. |
|
Das dynamisch erweiternde Image der virtuellen Festplatte benötigt mindestens 8 MB freien Speicherplatz auf dem Host-Volume. |
|
Der size-Parameter muss kleiner als 2.088.960 MB sein. Wenn das Format FAT16 ist, muss der Size-Parameter kleiner als 2000 MB sein. |
|
Images von unformatierten und FAT16-formatierten virtuellen Festplatten müssen mindestens 3 MB groß sein. IMAGES virtueller Festplatten im FAT32-Format müssen mindestens 514 MB groß sein. |
|
Das Host-Volume kann eine Datei dieser Größe nicht unterstützen. 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 die Anwendung heruntergefahren wurde. |
|
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization). |
|
Ein unerwarteter Fehler ist aufgetreten. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 7 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Ende des Supports (Client) |
Windows 7 |
| Produkt |
Windows Virtual PC |
| Header |
|
| IID |
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert. |