Metode IVdsLunPlex::QueryExtents (vdshwprv.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Mengembalikan array dari tingkat drive yang berkontribusi pada pleks.

Sintaks

HRESULT QueryExtents(
  [out] VDS_DRIVE_EXTENT **ppExtentArray,
  [out] LONG             *plNumberOfExtents
);

Parameter

[out] ppExtentArray

Penunjuk ke array pointer untuk mendorong jangkauan yang diteruskan oleh pemanggil. Ini adalah jangkauan yang berkontribusi pada pleks. Lihat struktur VDS_DRIVE_EXTENT . Pemanggil harus membebaskan array ini dengan menggunakan fungsi CoTaskMemFree .

[out] plNumberOfExtents

Penunjuk ke jumlah tingkat drive yang dikembalikan dalam ppExtentArray.

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
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
 Pleks LUN tidak lagi ada.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Pleks LUN 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 IVdsDrive::QueryExtents untuk mendapatkan jangkauan pada drive tertentu.

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

IVdsDrive::QueryExtents

IVdsHwProvider::Hitung ulang

IVdsHwProvider::Refresh

IVdsLunPlex

VDS_DRIVE_EXTENT