Metode IVMHardDisk::MergeTo

Artikel
06/13/2023

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

Menggabungkan hard disk virtual yang berbeda dengan semua induknya (hingga dan termasuk hard disk virtual induk akar) ke file hard disk baru.

Sintaks

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

Parameter

newDiskImagePath [in]: Jalur ke gambar disk target baru tempat gambar disk yang dipilih akan digabungkan.
newDiskImageType [in]: Jenis gambar disk target baru. Jenis gambar yang diizinkan untuk gambar disk target baru vmDiskType_Dynamic dan vmDiskType_FixedSize. Untuk informasi selengkapnya, lihat VMHardDiskType.
mergeTask [out, retval]: Objek IVMTask yang digunakan untuk melacak penyelesaian proses penggabungan.

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 newDiskImagePath kosong.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Sistem tidak dapat menemukan file yang ditentukan oleh parameter newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Sistem tidak dapat menemukan jalur yang ditentukan oleh parameter newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Parameter newDiskImagePath berisi karakter yang tidak valid (salah satu dari berikut ini: "*?<> /\|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Parameter newDiskImagePath menentukan jalur kosong atau relatif. Jalur absolut diperlukan.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Jalur yang ditentukan oleh parameter newDiskImagePath terlalu panjang. Jalur harus kurang dari 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.
VM_E_WRONG_HD_IMAGE_TYPE 0xA004067B	Kesalahan ini disebabkan karena gambar hard disk virtual yang direferensikan oleh objek IVMHardDisk ini bukan gambar disk yang berbeda atau karena parameter newDiskImageType bukan salah satu nilai yang diterima, vmDiskType_Dynamic atau vmDiskType_FixedSize.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	File yang direferensikan oleh parameter newDiskImagePath sudah ada.
HRESULT_FROM_WIN32(ERROR_DISK_FULL) 0x80070070	Volume host tidak memiliki cukup ruang untuk menggabungkan hard disk virtual ini.
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 digabungkan karena aplikasi sedang dimatikan.
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_IVMHardDisk didefinisikan sebagai ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Lihat juga

IVMHardDisk

Bagikan melalui