Metodo IVMHardDisk::MergeTo

  • Articolo

[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