Metodo IVMHardDisk::MergeTo

Articolo
06/13/2023

[PC virtuale Windows non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Unisce un disco rigido virtuale diverso con tutti i relativi elementi padre (fino a e includendo il disco rigido virtuale padre radice) in un nuovo file del disco rigido rigido.

Sintassi

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

Parametri

newDiskImagePath [in]: Percorso della nuova immagine del disco di destinazione in cui verranno unite le immagini del disco selezionate.
newDiskImageType [in]: Tipo di nuova immagine del disco di destinazione. I tipi di immagine consentiti per la nuova immagine del disco di destinazione sono vmDiskType_Dynamic e vmDiskType_FixedSize. Per altre informazioni, vedere VMHardDiskType.
mergeTask [out, retval]: Oggetto IVMTask utilizzato per tenere traccia del completamento del processo di unione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito	Descrizione
S_OK 0	L'operazione è stata completata.
E_POINTER 0x80004003	Un parametro è NULL.
E_INVALIDARG 0x80000003	Il parametro newDiskImagePath è vuoto.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Il sistema non riesce a trovare il file specificato dal parametro newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Il sistema non riesce a trovare il percorso specificato dal parametro newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Il parametro newDiskImagePath contiene un carattere non valido (uno dei seguenti: "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Il parametro newDiskImagePath specifica un percorso vuoto o relativo. È necessario un percorso assoluto.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Il percorso specificato dal parametro newDiskImagePath è troppo lungo. Il percorso deve essere inferiore a 260 caratteri.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) 0x80070020	Il disco rigido virtuale a cui fa riferimento questo oggetto è in uso o l'elemento padre di questo disco rigido virtuale è in uso.
VM_E_WRONG_HD_IMAGE_TYPE 0xA004067B	Questo errore si verifica perché l'immagine del disco rigido virtuale a cui fa riferimento questo oggetto IVMHardDisk non è un'immagine disco diversa o perché il parametro newDiskImageType non è uno dei valori accettati, vmDiskType_Dynamic o vmDiskType_FixedSize.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Il file a cui fa riferimento il parametro newDiskImagePath esiste già.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	Il volume host non dispone di spazio sufficiente per unire il disco rigido virtuale.
VM_E_PARENT_PATH_NOT_FOUND 0xA0040677	L'elemento padre del disco rigido virtuale a cui fa riferimento questo oggetto non esiste.
VM_E_APP_SHUTTING_DOWN 0xA0040209	Impossibile unire l'immagine del disco rigido virtuale perché l'applicazione viene arrestata.
DISP_E_EXCEPTION 0x80020009	Si è verificato un errore imprevisto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Fine del supporto client	Windows 7
Prodotto	Windows Virtual PC
Intestazione	VPCCOMInterfaces.h
IID	IID_IVMHardDisk è definito come ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Vedi anche

IVMHardDisk

Condividi tramite