Bagikan melalui

IVdsOpenVDisk::Metode penggabungan (vds.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Menggabungkan disk virtual anak dengan induknya dalam rantai yang berbeda.

Sintaks

HRESULT Merge(
  [in]  MERGE_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                   MergeDepth,
  [out] IVdsAsync               **ppAsync
);

Parameter

[in] Flags

Nilai enumerasi MERGE_VIRTUAL_DISK_FLAG yang menentukan bagaimana disk virtual akan digabungkan. Harus diatur ke MERGE_VIRTUAL_DISK_FLAG_NONE.

[in] MergeDepth

Jumlah disk induk dalam rantai yang berbeda untuk digabungkan bersama-sama. Disk harus terbuka dengan ReadWriteDepth setidaknya sama dengan nilai ini.

[out] ppAsync

Penunjuk ke antarmuka IVdsAsync yang setelah berhasil diselesaikan menerima antarmuka IVdsAsync untuk memantau dan mengontrol operasi ini. Penelepon harus merilis antarmuka yang diterima ketika mereka telah selesai dengannya. Jika metode IVdsAsync::Wait dipanggil pada antarmuka dan nilai HRESULT yang berhasil dikembalikan, antarmuka yang dikembalikan dalam struktur VDS_ASYNC_OUTPUT harus dirilis dengan memanggil metode IUnknown::Release pada setiap penunjuk antarmuka. Namun, jika Wait mengembalikan nilai HRESULT yang gagal, atau jika parameter pHrResultWait menerima nilai HRESULT yang gagal, penunjuk antarmuka dalam struktur VDS_ASYNC_OUTPUTadalah NULL dan tidak perlu dirilis. Anda dapat menguji keberhasilan atau kegagalan nilai HRESULT dengan menggunakan makro BERHASIL dan GAGAL yang ditentukan dalam Winerror.h.

Mengembalikan nilai

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.

Keterangan

Disk virtual hanya dapat digabungkan jika dicopot.

Metode ini memindahkan semua blok data dari disk anak ke induk. Namun, ini tidak akan menghapus disk anak yang tidak valid di akhir operasi.

Disk virtual harus telah dibuka dengan akses baca/tulis.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header vds.h
Pustaka Uuid.lib

Lihat juga

IVdsOpenVDisk