Metode IVdsAdvancedDisk::QueryPartitions (vds.h)

Artikel
03/08/2023

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

Mengembalikan detail semua partisi pada disk saat ini.

Sintaks

HRESULT QueryPartitions(
  [out] VDS_PARTITION_PROP **ppPartitionPropArray,
  [out] LONG               *plNumberOfPartitions
);

Parameter

[out] ppPartitionPropArray

Penunjuk ke array struktur VDS_PARTITION_PROP yang diteruskan oleh pemanggil. Pemanggil harus membebaskan array ini dengan menggunakan fungsi CoTaskMemFree .

[out] plNumberOfPartitions

Penunjuk ke jumlah elemen dalam array yang dikembalikan dalam parameter ppPartitionPropArray .

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.

Menampilkan kode	Deskripsi
S_OK	Kueri berhasil.
S_FALSE	Disk tidak berisi partisi.

Keterangan

Jika disk berisi partisi yang diperluas, metode ini hanya mengembalikan partisi yang diperluas pertama, terlepas dari berapa banyak partisi yang diperluas pada disk. Disk berisi satu partisi yang diperluas untuk setiap drive logis. Untuk informasi selengkapnya tentang drive logis, lihat Objek Disk.

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

Lihat juga

Objek Disk

IVdsAdvancedDisk

VDS_PARTITION_PROP