Metode IPortableDeviceCapabilities::GetFunctionalObjects (portabledeviceapi.h)

Artikel
08/25/2023

Metode GetFunctionalObjects mengambil semua objek fungsional yang cocok dengan kategori tertentu pada perangkat.

Sintaks

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

Parameter

[in] Category

REFGUID yang menentukan kategori yang akan dicari. Ini dapat WPD_FUNCTIONAL_CATEGORY_ALL untuk mengembalikan semua objek fungsional.

[out] ppObjectIDs

Alamat variabel yang menerima penunjuk ke antarmuka IPortableDevicePropVariantCollection yang berisi ID objek fungsional sebagai string (ketik VT_LPWSTR dalam item PROPVARIANT yang diambil). Jika tidak ada objek dari jenis yang diminta yang ditemukan, ini akan menjadi koleksi kosong (bukan NULL). Pemanggil harus merilis antarmuka ini ketika selesai dengannya.

Menampilkan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Operasi ini biasanya cepat, karena driver tidak perlu melakukan enumerasi konten lengkap, dan jumlah objek fungsi yang diambil biasanya kurang dari 10. Jika tidak ada objek dari jenis yang diminta yang ditemukan, metode ini tidak akan mengembalikan kesalahan, tetapi mengembalikan koleksi kosong untuk ppObjectIDs.