Metode IVdsServiceHba::QueryHbaPorts (vds.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]
Mengembalikan objek enumerasi IEnumVdsObject yang berisi daftar port HBA yang diketahui VDS pada sistem lokal.
Sintaks
HRESULT QueryHbaPorts(
[out] IEnumVdsObject **ppEnum
);
Parameter
[out] ppEnum
Alamat penunjuk antarmuka IEnumVdsObject yang dapat digunakan untuk menghitung port HBA sebagai objek port HBA. Untuk informasi selengkapnya, lihat Bekerja dengan Objek Enumerasi. Penelepon harus merilis antarmuka dan masing-masing objek port HBA 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. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.
| Mengembalikan kode/nilai | Deskripsi |
|---|---|
|
Enumerasi port HBA berhasil dikembalikan. Jika sistem lokal tidak memiliki port HBA, enumerasi kosong. |
|
VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan VDS selesai diinisialisasi, metode diblokir sampai inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan. |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | vds.h |