Bagikan melalui


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
S_OK
Mengembalikan enumerasi pengontrol. Jika subsistem tidak memiliki pengontrol, enumerasi kosong.
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
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.
VDS_E_OBJECT_DELETED
0x8004240BL
Objek subsistem tidak ada lagi.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
Subsistem dalam keadaan gagal dan tidak dapat melakukan operasi yang diminta.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
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

Lihat juga

IEnumVdsObject

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

IVdsSubSystem