IVMHardDisk::MergeTo-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).]

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

Freigeben über