IVMHardDisk::MergeTo-Methode

  • Artikel

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

Führt eine differenzierende virtuelle Festplatte mit allen übergeordneten Festplatten (bis einschließlich der virtuellen Stammfestplatte) in eine neue Festplattendatei zusammen.

Syntax

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

Parameter

newDiskImagePath [in]

Der Pfad zum neuen Zieldatenträgerimage, in dem die ausgewählten Datenträgerimages zusammengeführt werden.

newDiskImageType [in]

Der Typ des neuen Zieldatenträgerimages. Die für das neue Zieldatenträgerimage zulässigen Imagetypen sind vmDiskType_Dynamic und vmDiskType_FixedSize. Weitere Informationen finden Sie unter VMHardDiskType.

mergeTask [out, retval]

Ein IVMTask-Objekt , das verwendet wird, um den Abschluss des Zusammenführungsprozesses nachzuverfolgen.

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 parameter newDiskImagePath ist leer.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Das System kann die vom newDiskImagePath-Parameter angegebene Datei nicht finden.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Das System kann den pfad nicht finden, der durch den newDiskImagePath-Parameter angegeben wurde.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Der parameter newDiskImagePath enthält ein ungültiges Zeichen (eines der folgenden Zeichen: "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Der parameter newDiskImagePath gibt einen leeren oder relativen Pfad an. Ein absoluter Pfad ist erforderlich.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Der vom parameter newDiskImagePath angegebene Pfad ist zu lang. Der Pfad muss weniger als 260 Zeichen lang sein.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 Entweder wird die virtuelle Festplatte verwendet, auf die von diesem Objekt verwiesen wird, oder die übergeordnete Festplatte dieser virtuellen Festplatte wird verwendet.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 Dieser Fehler wird entweder verursacht, weil das virtuelle Festplattenimage, auf das von diesem IVMHardDisk-Objekt verwiesen wird, kein differenzierendes Datenträgerimage ist, oder weil der Parameter newDiskImageType keiner der akzeptierten Werte ist, vmDiskType_Dynamic oder vmDiskType_FixedSize.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Die Datei, auf die vom parameter newDiskImagePath verwiesen wird, ist bereits vorhanden.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 Das Hostvolume verfügt nicht über genügend Speicherplatz, um diese virtuelle Festplatte zusammenzuführen.
VM_E_PARENT_PATH_NOT_FOUND
0xA0040677
 Das übergeordnete Element der virtuellen Festplatte, auf die dieses Objekt verweist, ist nicht vorhanden.
VM_E_APP_SHUTTING_DOWN
0xA0040209
 Das virtuelle Festplattenimage kann nicht zusammengeführt werden, da die Anwendung heruntergefahren wird.
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_IVMHardDisk ist definiert als ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Siehe auch

IVMHardDisk