Metodo IVMVirtualPC::CreateDynamicVirtualHardDisk

  • Articolo

[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