Metode IVdsDisk::QueryExtents (vds.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 detail semua jangkauan pada disk.

Sintaks

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

Parameter

[out] ppExtentArray

Variabel penunjuk yang menerima
array struktur VDS_DISK_EXTENT . Penelepon harus membebaskan array ini dengan menggunakan fungsi CoTaskMemFree .

[out] plNumberOfExtents

Alamat jenis LONG yang mewakili jumlah total jangkauan.

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	Informasi jangkauan berhasil dikembalikan.
VDS_E_PACK_OFFLINE 0x80042444L	Paket tempat disk berada tidak dapat diakses.

Keterangan

Gunakan metode ini untuk menentukan jumlah ruang kosong yang tersedia untuk membuat atau memperluas volume. Anda juga dapat menggunakan informasi jangkauan untuk menentukan berapa banyak volume yang menempati disk. Jenis jangkauan yang valid adalah: jangkauan yang tidak diketahui, jangkauan bebas, jangkauan data, jangkauan OEM, tingkat ESP, jangkauan MSR, tingkat metadata LDM, dan jangkauan yang tidak dapat digunakan. Tingkat data berisi tautan ke volume di atasnya.

Jika disk adalah disk dinamis, disk harus online. Jika disk dasar atau disk mentah, disk tersebut dapat online atau offline.

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