IVMHardDisk::Convert-Methode

Artikel
06/13/2023

[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

Freigeben über