Metodo IVMVirtualPC::CreateDynamicVirtualHardDisk

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).]

Crea un disco rigido virtuale di ridimensionamento dinamico.

Sintassi

HRESULT CreateDynamicVirtualHardDisk(
  [in]          BSTR    imagePath,
  [in]          long    size,
  [out, retval] IVMTask **diskTask
);

Parametri

imagePath [in]: Percorso completo del nuovo file di immagine del disco. La cartella contenitore verrà creata se non esiste.
dimensioni [in]: Dimensioni dell'immagine, in megabyte. Questo valore può essere al massimo 2.088.960 MB (2040 GB).
diskTask [out, retval]: Oggetto IVMTask usato per tenere traccia della creazione dell'immagine.

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 size è minore o uguale a 0.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Il sistema non riesce a trovare il percorso specificato dal parametro imagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_DRIVE) 0x8007000f	Il file specificato dal parametro imagePath si trova in un CD-ROM o DVD-ROM.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Il parametro imagePath contiene un carattere non valido (uno di "*?:<>/\|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Entrambi i parametri imagePath specificano un percorso vuoto o relativo. Almeno uno dei parametri deve essere un percorso assoluto.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Il percorso specificato dal parametro imagePath è troppo lungo. La lunghezza del percorso deve essere inferiore a 260 caratteri.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Il file a cui fa riferimento il parametro imagePath esiste già.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	L'immagine del disco rigido virtuale in espansione dinamica richiede almeno 8 MB di spazio libero nel volume host.
VM_E_IMAGE_SIZE_TOO_LARGE 0xA0040683	Le dimensioni del parametro devono essere inferiori a 2.088.960 MB. Se il formato è FAT16, le dimensioni devono essere inferiori a 2000 MB.
VM_E_IMAGE_SIZE_TOO_SMALL 0xA0040684	Le immagini del disco rigido virtuale formattate e FAT16 non formattate devono essere di almeno 3 MB. Le immagini del disco rigido virtuale formattate in FAT32 devono essere di almeno 514 MB.
VM_E_FILE_TOO_LARGE_FOR_VOLUME 0xA0040679	Il volume host non può supportare un file di questa dimensione se l'immagine del disco rigido virtuale in espansione dinamica si espande fino al limite completo. La dimensione massima del file per un volume FAT32 è 4 GB. Le dimensioni massime del file per un volume FAT16 sono pari a 2 GB.
VM_E_APP_SHUTTING_DOWN 0xA0040209	Non è possibile creare il disco rigido virtuale dopo l'avvio dell'arresto dell'applicazione.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Il processore non supporta le estensioni HAV (Hardware Accelerated Virtualization).
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_IVMVirtualPC è definito come 236ba0d9-a24a-4292-a132-27c1421dfd01

Vedi anche

IVMVirtualPC

Condividi tramite