Metode IVMVirtualPC::CreateDynamicVirtualHardDisk

  • Artikel

[Windows Virtual PC tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan penyedia Hyper-V WMI (V2).]

Membuat hard disk virtual yang mengubah ukuran secara dinamis.

Sintaks

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

Parameter

imagePath [in]

Jalur lengkap ke file gambar disk baru. Folder yang berisi akan dibuat jika tidak ada.

size [in]

Ukuran gambar, dalam megabyte. Nilai ini paling banyak 2.088.960 MB (2040GB).

diskTask [out, retval]

Objek IVMTask yang digunakan untuk melacak pembuatan gambar.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0
 Operasi berhasil.
E_POINTER
0x80004003
 Parameter adalah NULL.
E_INVALIDARG
0x80000003
 Parameter ukuran kurang dari atau sama dengan 0.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 Sistem tidak dapat menemukan jalur yang ditentukan oleh parameter imagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_DRIVE)
0x8007000f
 File yang ditentukan oleh parameter imagePath ada di CD-ROM atau DVD-ROM.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 Parameter imagePath berisi karakter yang tidak valid (salah satu dari "*?:<>/|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 Kedua parameter imagePath menentukan jalur kosong atau relatif. Setidaknya salah satu parameter harus merupakan jalur absolut.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 Jalur yang ditentukan oleh parameter imagePath terlalu panjang. Panjang jalur harus kurang dari 260 karakter.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 File yang dirujuk oleh parameter imagePath sudah ada.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 Gambar hard disk virtual yang diperluas secara dinamis membutuhkan setidaknya 8 MB gratis pada volume host.
VM_E_IMAGE_SIZE_TOO_LARGE
0xA0040683
 Ukuran parameter harus kurang dari 2.088.960 MB. Jika formatnya adalah FAT16, maka ukurannya harus kurang dari 2000 MB.
VM_E_IMAGE_SIZE_TOO_SMALL
0xA0040684
 Gambar hard disk virtual yang tidak diformat dan berformat FAT16 harus minimal 3 MB. Gambar hard disk virtual berformat FAT32 harus minimal 514 MB.
VM_E_FILE_TOO_LARGE_FOR_VOLUME
0xA0040679
 Volume host tidak dapat mendukung file sebesar ini jika gambar hard disk virtual yang diperluas secara dinamis meluas ke batas penuhnya. Ukuran file maksimum untuk volume FAT32 adalah 4 GB. Ukuran file maksimum untuk volume FAT16 adalah 2 GB.
VM_E_APP_SHUTTING_DOWN
0xA0040209
 Hard disk virtual tidak dapat dibuat setelah aplikasi mulai dimatikan.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Prosesor tidak mendukung ekstensi Hardware Accelerated Virtualization (HAV).
DISP_E_EXCEPTION
0x80020009
 Terjadi kesalahan tidak terduga.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung
 Tidak ada yang didukung
Akhir dukungan klien
 Windows 7
Produk
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPC didefinisikan sebagai 236ba0d9-a24a-4292-a132-27c1421dfd01

Lihat juga

IVMVirtualPC