Metode IVdsDrive::QueryExtents (vds.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]
Mengembalikan array sejauh mana pada drive, termasuk tingkat yang dialokasikan dan tidak dialokasikan.
Sintaks
HRESULT QueryExtents(
[out] VDS_DRIVE_EXTENT **ppExtentArray,
[out] LONG *plNumberOfExtents
);
Parameter
[out] ppExtentArray
Penunjuk ke array struktur VDS_DRIVE_EXTENT diteruskan oleh pemanggil. Penelepon harus membebaskan array ini dengan menggunakan fungsi CoTaskMemFree .
[out] plNumberOfExtents
Penunjuk ke jumlah tingkat drive yang dikembalikan dalam struktur VDS_DRIVE_EXTENT .
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 |
---|---|
|
Informasi jangkauan berhasil dikembalikan. Untuk drive tanpa batasan, array kosong, nilai plNumberOfExtents diatur ke 0, dan nilai ppExtentArray diatur ke NULL. |
|
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. |
|
Objek drive tidak ada lagi. |
|
Drive dalam status gagal, dan tidak dapat melakukan operasi yang diminta. |
|
Operasi lain sedang berlangsung; operasi ini tidak dapat dilanjutkan sampai operasi atau operasi sebelumnya selesai. |
|
Subsistem tidak mendukung metode ini. |
Keterangan
Drive dapat berkontribusi hingga sejumlah LUN, dan LUN ini dapat dilepaskan ke sejumlah komputer yang berbeda di jaringan. Gunakan metode IVdsLunPlex::QueryExtents untuk melihat semua tingkat pleks LUN.
Anggota LunId dari setiap struktur VDS_DRIVE_EXTENT menentukan GUID untuk LUN yang masing-masing dialokasikan berkontribusi. Akibatnya, Anda dapat menggunakan hasil metode ini untuk menentukan jumlah LUN yang dikontribusikan drive dengan menghitung jumlah nilai LunId berbeda yang dikembalikan dalam ppExtentArray.
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 | vds.h |
Pustaka | Uuid.lib |