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
S _ OK
0
Der Vorgang wurde durchgeführt.
E _ POINTER
0x80004003
Ein Parameter ist NULL.
HRESULT _ VON _ WIN32(FEHLERPFAD _ _ NICHT _ GEFUNDEN)
0X80070003
Das System kann den durch den imagePath- oder parentPath-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- oder parentPath-Parameter enthält ein ungültiges Zeichen (eines von " * ?:<>/ | "").
HRESULT _ FROM _ WIN32(ERROR _ BAD _ PATHNAME)
0x800700a1
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.
HRESULT _ FROM _ WIN32(ERROR _ BUFFER _ OVERFLOW)
0x8007006f
Der durch die parameter imagePath oder parentPath 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.

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

Weitere Informationen

IVMVirtualPC