Metode IVdsController::QueryAssociatedLuns (vdshwprv.h)

[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

Lihat juga

IEnumVdsObject

IVdsController

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

IVdsLun::AssociateControllers

IVdsLun::QueryActiveControllers