Metode IPortableDeviceProperties::GetValues (portabledeviceapi.h)

Artikel
08/25/2023

Metode GetValues mengambil daftar properti tertentu dari objek tertentu pada perangkat.

Sintaks

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Parameter

[in] pszObjectID

Penunjuk ke string yang dihentikan null yang berisi ID objek yang akan dikueri. Untuk menentukan perangkat, gunakan WPD_DEVICE_OBJECT_ID.

[in] pKeys

Penunjuk ke antarmuka IPortableDeviceKeyCollection yang berisi satu atau beberapa properti untuk dikueri. Jika ini ADALAH NULL, semua properti akan diambil. Lihat Properti dan Atribut untuk daftar properti yang ditentukan oleh Perangkat Portabel Windows.

[out] ppValues

Alamat variabel yang menerima penunjuk ke antarmuka IPortableDeviceValues yang berisi nilai properti yang diminta. Ini akan dikembalikan sebagai pasangan PROPERTYKEY/nilai, di mana jenis data nilai bergantung pada properti . Jika nilai tidak dapat diambil karena alasan tertentu, jenis yang dikembalikan akan VT_ERROR, dan berisi nilai HRESULT yang menjelaskan kesalahan pengambilan. Pemanggil harus merilis antarmuka ini ketika selesai.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Semua nilai properti yang diminta diambil.
S_FALSE	Satu atau beberapa nilai properti tidak dapat diambil. Properti masalah akan memiliki nilai HRESULT dalam parameter ppValues yang diambil.