Metode IVdsVolume::BreakPlex (vds.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Menghapus pleks tertentu dari volume saat ini. Penunjuk antarmuka untuk objek volume baru dapat diambil dengan memanggil IVdsAsync::Wait melalui parameter ppAsync . Struktur VDS_ASYNC_OUTPUT yang dikembalikan berisi penunjuk antarmuka objek volume di anggota bvp.pVolumeUnk .

Sintaks

HRESULT BreakPlex(
  [in]  VDS_OBJECT_ID plexId,
  [out] IVdsAsync     **ppAsync
);

Parameter

[in] plexId

GUID pleks yang akan dipecah.

[out] ppAsync

Alamat penunjuk antarmuka IVdsAsync , yang diinisialisasi VDS saat dikembalikan. Penelepon harus merilis antarmuka. Gunakan penunjuk ini untuk membatalkan, menunggu, atau mengkueri status operasi.

Jika Anda memanggil IVdsAsync::Wait pada metode ini dan nilai HRESULT yang berhasil dikembalikan, Anda harus merilis antarmuka yang dikembalikan dalam struktur VDS_ASYNC_OUTPUT dengan memanggil metode IUnknown::Release pada setiap pointer antarmuka. Namun, jika Wait mengembalikan nilai HRESULT kegagalan, atau jika parameter pHrResultWait menerima nilai HRESULT kegagalan, penunjuk antarmuka dalam struktur VDS_ASYNC_OUTPUT adalah 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. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Pleks berhasil rusak.
VDS_E_VOLUME_NOT_ONLINE 0x8004243DL	Volume tidak tersedia.
VDS_E_VOLUME_NOT_A_MIRROR 0x80042445L	Volume bukan cermin.

Keterangan

Operasi ini tidak valid untuk volume dasar, yang memiliki tepat satu pleks.

Gunakan metode ini untuk memecah cermin. Pleks yang rusak menjadi volume baru. Jika pleks yang tersisa basi atau hilang, VDS menghentikan operasi dan mengembalikan kesalahan. Perhatikan bahwa VDS melepas volume selama operasi.

Boot atau pleks sistem—pada dasarnya, pleks yang digunakan untuk mem-boot komputer—tidak valid untuk plexId. Ketika melewati pleks seperti itu, VDS menghentikan operasi dan mengembalikan kesalahan.

Pelaksana harus mengembalikan pointer ke antarmuka IVdsAsync untuk metode ini, terlepas dari apakah panggilan memulai operasi asinkron.

Persyaratan

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

Lihat juga

Bagikan melalui