Metodo IVMHardDisk::Convert

Articolo
06/13/2023

[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

Condividi tramite