Metode IVdsController::QueryAssociatedLuns (vdshwprv.h)

Artikel
03/03/2024

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Mengembalikan enumerasi LUN yang dikaitkan dengan pengontrol—dengan kata lain, LUN yang pengontrolnya aktif.

Sintaks

HRESULT QueryAssociatedLuns(
  [out] IEnumVdsObject **ppEnum
);

Parameter

[out] ppEnum

Alamat penunjuk antarmuka IEnumVdsObject yang dapat digunakan untuk menghitung LUN sebagai objek LUN. Untuk informasi selengkapnya, lihat Bekerja dengan Objek Enumerasi. Penelepon harus merilis antarmuka dan masing-masing objek LUN 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 LUN terkait. Jika pengontrol tidak memiliki LUN terkait, 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 pengontrol tidak ada lagi.
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	Pengontrol dalam status gagal, dan tidak dapat melakukan operasi yang diminta.
VDS_E_NOT_SUPPORTED 0x80042400L	Operasi atau kombinasi parameter ini tidak didukung oleh penyedia ini.

Keterangan

Gunakan metode IVdsLun::AssociateControllers untuk mendapatkan pengontrol yang terkait dengan satu LUN.

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