IVMVirtualPC::CreateDifferencingVirtualHardDisk-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr 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 Imagedatei des übergeordneten Datenträgers.

diskTask [out, retval]

Ein IVMTask-Objekt , das zum Nachverfolgen der Erstellung des Bilds 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_FROM_WIN32(ERROR_PATH_NOT_FOUND)
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 parameter imagePath oder parentPath enthält ein ungültiges Zeichen (eines von "*?:<>/|").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Sowohl der imagePath - 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 den imagePath- oder parentPath-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 expandierende virtuelle Festplattenimage benötigt mindestens 8 MB frei 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 2000 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 expandierende image der virtuellen Festplatte auf sein volles Limit 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_E_APP_SHUTTING_DOWN
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.

Bemerkungen

Obwohl imagePath oder parentPath ein relativer Pfad sein können, muss mindestens einer dieser Pfade 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)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Nicht unterstützt
Ende des Supports (Client)
 Windows 7
Produkt
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPC ist definiert als 236ba0d9-a24a-4292-a132-27c1421dfd01

Siehe auch

IVMVirtualPC