Metode IVdsHwProviderStoragePools::QueryStoragePools (vdshwprv.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Mengembalikan objek enumerasi IEnumVdsObject yang berisi daftar kumpulan penyimpanan yang dikelola oleh penyedia perangkat keras.

Sintaks

HRESULT QueryStoragePools(
  [in]  ULONG               ulFlags,
  [in]  ULONGLONG           ullRemainingFreeSpace,
  [in]  VDS_POOL_ATTRIBUTES *pPoolAttributes,
  [out] IEnumVdsObject      **ppEnum
);

Parameter

[in] ulFlags

Bitmask dari satu atau beberapa bendera VDS_STORAGE_POOL_TYPE yang menentukan jenis kumpulan penyimpanan yang akan dikueri. Salah satu bendera harus VDS_SPT_CONCRETE atau VDS_SPT_PRIMORDIAL. Nilai default dari parameter ini adalah nol. Nilai nol berarti bahwa semua kumpulan penyimpanan harus dikueri.

[in] ullRemainingFreeSpace

Jumlah minimum ruang kosong, dalam byte, yang harus dimuat oleh setiap kumpulan penyimpanan. Nilai default untuk parameter ini adalah nol. Nilai nol berarti bahwa kumpulan penyimpanan dapat berisi sejumlah ruang kosong.

[in] pPoolAttributes

Penunjuk ke struktur VDS_POOL_ATTRIBUTES yang menentukan nilai atribut yang harus dimiliki kumpulan penyimpanan yang dikembalikan. Nilai default untuk parameter ini adalah NULL. Nilai NULL berarti bahwa kumpulan penyimpanan dapat memiliki nilai atribut apa pun.

[out] ppEnum

Alamat penunjuk antarmuka IEnumVdsObject yang dapat digunakan untuk menghitung kumpulan penyimpanan. Untuk informasi selengkapnya, lihat Bekerja dengan Objek Enumerasi. Penelepon harus merilis antarmuka dan masing-masing objek kumpulan penyimpanan ketika tidak lagi diperlukan dengan memanggil metode IUnknown::Release . Parameter ini diperlukan dan tidak boleh NULL.

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.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.

Keterangan

Jika penyedia perangkat keras tidak mengelola kumpulan penyimpanan apa pun, metode ini mengembalikan objek enumerasi kosong.

Jika nilai non-NULL ditentukan dalam parameter pPoolAttributes , metode ini hanya mengembalikan kumpulan penyimpanan yang memenuhi semua atribut yang ditentukan dalam struktur VDS_POOL_ATTRIBUTES . Jika ada atribut minimum dan maksimum yang ditentukan, kumpulan penyimpanan yang dikembalikan harus sama persis dengan atribut ini. Atribut petunjuk digunakan sebagai petunjuk untuk memfilter kumpulan penyimpanan lebih lanjut yang memenuhi semua atribut yang ditentukan. Jika atribut yang ditentukan tidak berlaku untuk salah satu kumpulan penyimpanan, metode ini mengembalikan S_OK dengan objek enumerasi kosong.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	vdshwprv.h
Pustaka	Uuid.lib

Lihat juga

IVdsHwProviderStoragePools