Metode IVdsSubSystem::QueryControllers (vdshwprv.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]
Mengembalikan objek yang menghitung pengontrol online dan offline yang dikelola oleh subsistem.
Sintaks
HRESULT QueryControllers(
[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. Jika subsistem tidak memiliki pengontrol, 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 subsistem tidak ada lagi. |
|
Subsistem dalam keadaan 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 QueryControllers untuk mendapatkan jumlah pengontrol, lalu hitung pengontrol dalam enumerasi yang dikembalikan.
Jika subsistem tidak memiliki pengontrol, metode ini mengembalikan objek enumerasi kosong.
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 |