IVMHardDisk::Convert-Methode

[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung verfügbar. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Konvertiert eine virtuelle Festplatte mit fester Größe in eine dynamisch erweiterbare virtuelle Festplatte oder konvertiert eine dynamisch erweiterbare 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 Zieldatenträger-Imagedatei.

convertedDiskImageType [ In]

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

convertTask [ out, retval]

Ein IVMTask-Objekt, das zum Nachverfolgen des Abschlusses des Konvertierungsprozesses 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 _ INVALIDARG-0x80000003
Der convertedDiskImagePath-Parameter ist leer oder enthält keine VHD-Erweiterung für den Dateinamen.
E _ POINTER
0x80004003
Ein Parameter ist NULL.
HRESULT _ FROM _ WIN32(ERROR _ PATH NOT _ _ FOUND)
0x80070003
Das System kann den vom convertedDiskImagePath-Parameter angegebenen Pfad nicht finden.
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 vom 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 verwendet, auf die dieses Objekt verweist, oder das übergeordnete Element dieser virtuellen Festplatte wird verwendet.
HRESULT _ FROM _ WIN32(ERROR _ DISK _ FULL)
0x80070070
Das Hostvolume verfügt nicht über genügend Speicherplatz zum Konvertieren dieser virtuellen Festplatte.
HRESULT _ VON _ WIN32(FEHLER _ IST BEREITS _ VORHANDEN)
0X800700B7
Die Datei, auf die der convertedDiskImagePath-Parameter verweist, 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 image der virtuellen Festplatte, auf das dieses IVMHardDisk-Objekt verweist, scheint kein gültiges Image zu sein.
VM _ _E _ ÜBERGEORDNETER PFAD _ NICHT _ GEFUNDEN
0XA0040677
Das übergeordnete Element der virtuellen Festplatte, auf die dieses Objekt verweist, ist nicht vorhanden.
VM _ E _ APP _ SHUTING _ 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)
nur Windows 7 [ 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 als ffa14ae6-48f5-42a4-8a22-186f2e5c7db0 definiert.

Weitere Informationen

IVMHardDisk