IVMVirtualPC::CreateDynamicVirtualHardDisk-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Erstellt eine dynamische Größenänderung einer 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.

Größe [in]

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

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 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.

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