IVdsVolume::RemovePlex method (vds.h)

Artikel
03/03/2024

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

Menghapus satu atau beberapa pleks yang ditentukan dari volume saat ini, melepaskan sejauh mana.

Sintaks

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

Parameter

[in] plexId

GUID pleks yang akan dihapus.

[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.

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 dihapus.
VDS_E_VOLUME_NOT_ONLINE 0x8004243DL	Volume tidak dapat diakses.
VDS_E_VOLUME_NOT_A_MIRROR 0x80042445L	Volume bukan cermin.

Keterangan

Operasi ini tidak dapat menghapus pleks terakhir volume. Sebagai gantinya, gunakan metode IVdsVolume::D elete untuk menghapus volume terakhir yang tersisa (satu-satu pleks). Metode ini tidak valid untuk volume dasar, yang memiliki tepat satu pleks.

VDS tidak melepas volume saat menghapus pleks.

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

IVdsAsync

IVdsVolume

IVdsVolume::D elete

Bagikan melalui