IVMHardDisk::Convert-Methode

  • Artikel

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

Konvertiert eine virtuelle Festplatte mit fester Größe in eine dynamisch expandierende virtuelle Festplatte oder konvertiert eine dynamisch erweiternde virtuelle Festplatte in eine virtuelle Festplatte mit fester Größe.

Syntax

HRESULT Convert(
  [in]          BSTR           convertedDiskImagePath,
  [in]          VMHardDiskType convertedDiskImageType,
  [out, retval] IVMTask        **convertTask
);

Parameter

convertedDiskImagePath [in]

Der Pfad zur Imagedatei des Zieldatenträgers.

convertedDiskImageType [in]

Der Typ des Zieldatenträgerimages. Eine Liste der Werte finden Sie unter VMHardDiskType.

convertTask [out, retval]

Ein IVMTask-Objekt , das verwendet wird, um den Abschluss des Konvertierungsprozesses nachzuverfolgen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
 Der Vorgang wurde durchgeführt.
E_INVALIDARG
0x80000003
 Der convertedDiskImagePath-Parameter ist leer oder fehlt die Erweiterung .vhd im Dateinamen.
E_POINTER
0x80004003
 Ein Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Der durch den convertedDiskImagePath-Parameter angegebene Pfad kann vom System nicht gefunden werden.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Der convertedDiskImagePath-Parameter enthält ein ungültiges Zeichen (eines von "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Der convertedDiskImagePath-Parameter gibt einen leeren oder relativen Pfad an. Ein absoluter Pfad ist erforderlich.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Der durch den convertedDiskImagePath-Parameter angegebene Pfad ist zu lang. Der Pfad muss kleiner als MAX_PATH (260) Zeichen sein.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 Entweder wird die virtuelle Festplatte, auf die von diesem Objekt verwiesen wird, verwendet, oder die übergeordnete Festplatte dieser virtuellen Festplatte wird verwendet.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 Das Hostvolume verfügt nicht über genügend Speicherplatz, um diese virtuelle Festplatte zu konvertieren.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Die Datei, auf die vom convertedDiskImagePath-Parameter verwiesen wird, ist bereits vorhanden.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 Der convertedDiskImagePath-Parameter muss entweder vmDiskType_Dynamic oder vmDiskType_FixedSize sein.
VM_E_INVALID_HD_FILE
0xA0040682
 Das virtuelle Festplattenimage, auf das von diesem IVMHardDisk-Objekt verwiesen wird, scheint kein gültiges Image zu sein.
VM_E_PARENT_PATH_NOT_FOUND
0xA0040677
 Das übergeordnete Element der virtuellen Festplatte, auf die von diesem Objekt verwiesen wird, ist nicht vorhanden.
VM_E_APP_SHUTTING_DOWN
0xA0040209
 Das Image der virtuellen Festplatte kann nicht konvertiert werden, da die Anwendung heruntergefahren wird.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Die Quelldatei bleibt nach dem Konvertierungsprozess intakt.

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_IVMHardDisk ist definiert als ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Weitere Informationen

IVMHardDisk