IVMVirtualPC::CreateDynamicVirtualHardDisk-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 dynamische Größenänderung der virtuellen Festplatte.

Syntax

HRESULT CreateDynamicVirtualHardDisk(
  [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 (Größe) [ In]

Die Größe des Bilds in Megabyte. Dieser Wert kann höchstens 2.088.960 MB (2.040 GB) betragen.

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
S _ OK
0
Der Vorgang wurde durchgeführt.
E _ POINTER
0x80004003
Ein Parameter ist NULL.
E _ INVALIDARG-0x80000003
Der size-Parameter ist kleiner oder gleich 0.
HRESULT _ VON _ WIN32(FEHLERPFAD _ _ NICHT _ GEFUNDEN)
0X80070003
Das System kann den vom imagePath-Parameter angegebenen Pfad nicht finden.
HRESULT _ FROM _ WIN32(ERROR _ INVALID _ DRIVE)
0x8007000f
Die durch den imagePath-Parameter angegebene Datei befindet sich auf einer CD-ROM oder DVD-ROM.
HRESULT _ FROM _ WIN32(ERROR _ INVALID _ NAME)
0x8007007b
Der imagePath-Parameter enthält ein ungültiges Zeichen (eines von " * ?:<>| /"").
HRESULT _ FROM _ WIN32(ERROR _ BAD _ PATHNAME)
0x800700a1
Der imagePath-Parameter gibt einen leeren oder relativen Pfad an. Mindestens einer der Parameter muss ein absoluter Pfad sein.
HRESULT _ FROM _ WIN32(ERROR _ BUFFER _ OVERFLOW)
0x8007006f
Der vom imagePath-Parameter angegebene Pfad ist zu lang. Die Länge des Pfads muss kleiner als 260 Zeichen sein.
HRESULT _ FROM _ WIN32(ERROR _ ALREADY _ EXISTS)
0x800700b7
Die Datei, auf die vom imagePath-Parameter verwiesen wird, ist bereits vorhanden.
HRESULT _ FROM _ WIN32(ERROR _ DISK _ FULL)
0x80070070
Das dynamisch erweiterbare virtuelle Festplattenimage benötigt mindestens 8 MB freien Speicherplatz auf dem Hostvolume.
VM _ E _ IMAGE SIZE TOO _ _ _ LARGE
0xA0040683
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.
VM _ E _ IMAGE SIZE TOO _ _ _ SMALL
0xA0040684
Unformatierte und FAT16-formatierte virtuelle Festplattenimages müssen mindestens 3 MB groß sein. Fat32-formatierte virtuelle Festplattenimages müssen mindestens 514 MB groß sein.
VM _ E _ FILE TOO LARGE FOR _ _ _ _ VOLUME
0xA0040679
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.
VM _ HERUNTERFAHREN _ _ DER _ E-APP
0xA0040209
Die virtuelle Festplatte kann nicht erstellt werden, nachdem das Herunterfahren der Anwendung gestartet wurde.
VM _ E _ HARDWARE _ VIRTUALIZATION _ DISABLED
0xA0040951
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization).
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

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
VPCCOMInterfaces.h
IID
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert.

Siehe auch

IVMVirtualPC