Metode IVdsLun::QueryActiveControllers (vdshwprv.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]
Mengembalikan enumerasi pengontrol yang saat ini aktif—pengontrol tempat LUN dapat diakses.
Sintaks
HRESULT QueryActiveControllers(
[out] IEnumVdsObject **ppEnum
);
Parameter
[out] ppEnum
Alamat penunjuk antarmuka IEnumVdsObject yang dapat digunakan untuk menghitung pengontrol di subsistem sebagai objek pengontrol. Untuk informasi selengkapnya, lihat Bekerja dengan Objek Enumerasi. Penelepon harus merilis antarmuka dan masing-masing objek pengontrol ketika tidak lagi diperlukan dengan memanggil metode IUnknown::Release .
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 |
---|---|
|
Mengembalikan enumerasi pengontrol aktif. Jika LUN tidak memiliki pengontrol aktif, enumerasi kosong. |
|
Nilai pengembalian ini menandakan masalah perangkat lunak atau komunikasi di dalam penyedia yang menyimpan informasi tentang array. Gunakan metode IVdsHwProvider::Reenumerate diikuti dengan metode IVdsHwProvider::Refresh untuk memulihkan cache. |
|
Objek LUN tidak lagi ada. |
|
LUN dalam status gagal dan tidak dapat melakukan operasi yang diminta. |
|
Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi atau operasi sebelumnya selesai. |
Keterangan
Gunakan metode IVdsLun::AssociateControllers untuk mengatur pengontrol. Gunakan metode IVdsController::QueryAssociatedLuns untuk mengkueri LUN yang terkait dengan pengontrol tertentu.
Sebagian besar subsistem hanya menawarkan satu pengontrol aktif untuk LUN, meninggalkan pengontrol lain dalam mode siaga. Namun, beberapa produsen subsistem memang mengizinkan beberapa pengontrol aktif secara bersamaan.
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 | vdshwprv.h |
Pustaka | Uuid.lib |