IVMHardDisk::Konversi metode

Artikel
06/13/2023

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

Mengonversi hard disk virtual ukuran tetap ke hard disk virtual yang diperluas secara dinamis atau mengonversi hard disk virtual yang diperluas secara dinamis ke hard disk virtual ukuran tetap.

Sintaks

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

Parameter

convertedDiskImagePath [in]: Jalur ke file gambar disk target.
convertedDiskImageType [in]: Jenis gambar disk target. Untuk daftar nilai, lihat VMHardDiskType.
convertTask [out, retval]: Objek IVMTask yang digunakan untuk melacak penyelesaian proses konversi.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai	Deskripsi
S_OK 0	Operasi berhasil.
E_INVALIDARG 0x80000003	Parameter convertedDiskImagePath kosong atau tidak memiliki ekstensi .vhd pada nama file.
E_POINTER 0x80004003	Parameter adalah NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Sistem tidak dapat menemukan jalur yang ditentukan oleh parameter convertedDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Parameter convertedDiskImagePath berisi karakter yang tidak valid (salah satu dari "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Parameter convertedDiskImagePath menentukan jalur kosong atau relatif. Jalur absolut diperlukan.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Jalur yang ditentukan oleh parameter convertedDiskImagePath terlalu panjang. Jalur harus kurang dari MAX_PATH (260) karakter.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION) 0x80070020	Baik hard disk virtual yang dirujuk oleh objek ini sedang digunakan atau induk dari hard disk virtual ini sedang digunakan.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	Volume host tidak memiliki cukup ruang untuk mengonversi hard disk virtual ini.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	File yang direferensikan oleh parameter convertedDiskImagePath sudah ada.
VM_E_WRONG_HD_IMAGE_TYPE 0xA004067B	Parameter convertedDiskImagePath harus vmDiskType_Dynamic atau vmDiskType_FixedSize.
VM_E_INVALID_HD_FILE 0xA0040682	Gambar hard disk virtual yang dirujuk oleh objek IVMHardDisk ini tampaknya bukan gambar yang valid.
VM_E_PARENT_PATH_NOT_FOUND 0xA0040677	Induk dari hard disk virtual yang dirujuk oleh objek ini tidak ada.
VM_E_APP_SHUTTING_DOWN 0xA0040209	Citra hard disk virtual tidak dapat dikonversi karena aplikasi sedang dimatikan.
DISP_E_EXCEPTION 0x80020009	Terjadi kesalahan tidak terduga.

Keterangan

File sumber dibiarkan utuh setelah proses konversi.

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_IVMHardDisk didefinisikan sebagai ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Lihat juga

IVMHardDisk

Bagikan melalui