Metode IVdsVolume::AddPlex (vds.h)

  • Artikel

[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