IVMVirtualPC::CreateFixedVirtualHardDisk-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. 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.

Größe [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 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.
E_INVALIDARG
0x80000003
 Der Size-Parameter ist kleiner oder gleich 0.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Das System kann den durch den 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
 Sowohl 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 durch den imagePath-Parameter angegebene Pfad ist zu lang. Die Länge des Pfads muss kleiner als MAX_PATH (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
 Der Größenparameter muss kleiner als 2.088.960 MB sein. Wenn das Format FAT16 ist, muss der Größenparameter 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. 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.

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