Metode IVdsVolume::AddPlex (vds.h)

Artikel
03/03/2024

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

Menambahkan volume sebagai pleks ke volume saat ini.

Sintaks

HRESULT AddPlex(
  [in]  VDS_OBJECT_ID VolumeId,
  [out] IVdsAsync     **ppAsync
);

Parameter

[in] VolumeId

GUID volume yang akan ditambahkan sebagai pleks.

[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. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Pleks berhasil ditambahkan.
VDS_S_GPT_BOOT_MIRRORED_TO_MBR 0x80042469L	Volume boot pada disk GPT telah dicerminkan ke disk MBR. Pleks baru tidak dapat digunakan untuk mem-boot komputer.
VDS_E_VOLUME_NOT_ONLINE 0x8004243DL	Volume tidak dapat diakses.
VDS_E_VOLUME_NOT_HEALTHY 0x8004243EL	Volume gagal atau gagal.
VDS_E_VOLUME_SPANS_DISKS 0x8004243FL	Volume mencakup beberapa disk.
VDS_E_REQUIRES_CONTIGUOUS_DISK_SPACE 0x80042440L	Volume terdiri dari beberapa jangkauan.
VDS_E_INVALID_OPERATION 0x80042415L	Volume sumber lebih kecil dari volume target. Jika volume sumber lebih besar dari volume target, volume target tetap berukuran sama dan operasi berhasil.

Keterangan

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

Gunakan metode ini untuk menambahkan volume sebagai pleks ke volume lain. Misalnya, penelepon dapat membuat volume (volume B), menentukan volume B sebagai pleks baru ke volume yang ada (volume A), lalu menghapus volume B. Pleks baru Volume A menempati tingkat disk yang sama seperti volume B.

Catatan VDS mencoba menggunakan tingkat yang sama, tetapi tidak dapat menjamin perilaku ini.

Penelepon dapat menambahkan volume cermin sebagai pleks baru ke volume lain. Volume yang dihasilkan berisi pleks yang sama dengan jumlah jumlah volume asli.

Pelaksana harus mengembalikan penunjuk 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

Objek Volume Plex

Bagikan melalui