Metodo IVMHardDisk::Convert

  • Articolo

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

Converte un disco rigido virtuale di dimensioni fisse in un disco rigido virtuale in modo dinamico o converte un disco rigido virtuale in modo dinamico in un disco rigido virtuale di dimensioni fisse.

Sintassi

HRESULT Convert(
  [in]          BSTR           convertedDiskImagePath,
  [in]          VMHardDiskType convertedDiskImageType,
  [out, retval] IVMTask        **convertTask
);

Parametri

convertDiskImagePath [in]

Percorso del file di immagine del disco di destinazione.

convertDiskImageType [in]

Tipo dell'immagine del disco di destinazione. Per un elenco di valori, vedere VMHardDiskType.

convertTask [out, retval]

Oggetto IVMTask usato per tenere traccia del completamento del processo di conversione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice/valore restituito Descrizione
S_OK
0
 L'operazione è stata completata.
E_INVALIDARG
0x80000003
 Il parametro convertDiskImagePath è vuoto o manca l'estensione vhd nel nome del file.
E_POINTER
0x80004003
 Un parametro è NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Il sistema non riesce a trovare il percorso specificato dal parametro convertDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Il parametro convertDiskImagePath contiene un carattere non valido (uno di "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Il parametro convertDiskImagePath specifica un percorso vuoto o relativo. È necessario un percorso assoluto.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Il percorso specificato dal parametro convertDiskImagePath è troppo lungo. Il percorso deve essere minore di MAX_PATH (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.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 Il volume host non ha spazio sufficiente per convertire questo disco rigido virtuale.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Il file a cui fa riferimento il parametro convertdiskImagePath esiste già.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 Il parametro convertDiskImagePath deve essere vmDiskType_Dynamic o vmDiskType_FixedSize.
VM_E_INVALID_HD_FILE
0xA0040682
 L'immagine del disco rigido virtuale a cui fa riferimento questo oggetto IVMHardDisk non sembra essere un'immagine valida.
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 convertire l'immagine del disco rigido virtuale perché l'applicazione viene arrestata.
DISP_E_EXCEPTION
0x80020009
 Si è verificato un errore imprevisto.

Commenti

Il file di origine viene lasciato intatto dopo il processo di conversione.

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