Metode IPortableDeviceProperties::GetPropertyAttributes (portabledeviceapi.h)

Artikel
03/01/2024

Metode GetPropertyAttributes mengambil atribut properti objek tertentu pada perangkat.

Sintaks

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Parameter

[in] pszObjectID

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

[in] Key

REFPROPERTYKEY yang menentukan properti yang akan dikueri. Anda dapat mengambil daftar properti yang didukung dengan memanggil GetSupportedProperties. Untuk daftar properti yang ditentukan oleh Perangkat Portabel Windows, lihat Properti dan Atribut.

[out] ppAttributes

Alamat variabel yang menerima penunjuk ke antarmuka IPortableDeviceValues yang menyimpan atribut properti yang diambil. Ini adalah pasangan PROPERTYKEY/nilai, di mana PROPERTYKEY adalah properti , dan jenis data nilai tergantung pada properti tertentu. Pemanggil harus merilis antarmuka ini ketika selesai. Atribut yang ditentukan oleh Perangkat Portabel Windows dapat ditemukan di halaman Properti dan Atribut .

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil, dan semua atribut berhasil diambil.
S_FALSE	Hanya beberapa nilai atribut yang dapat diambil. Yang lain tidak bisa, dan akan berisi nilai HRESULT jenis VT_ERROR.
E_POINTER	Argumen pointer yang diperlukan adalah NULL.

Keterangan

Atribut properti menjelaskan hak akses properti, nilai yang valid, dan informasi lainnya. Misalnya, properti dapat memiliki nilai WPD_PROPERTY_ATTRIBUTE_CAN_DELETE diatur ke False untuk mencegah penghapusan, dan memiliki rentang nilai valid yang disimpan sebagai entri individual.

Contoh

Untuk contoh cara menggunakan metode ini, lihat Mengatur Properti untuk Objek Tunggal.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	portabledeviceapi.h
Pustaka	PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceProperties

Mengatur Properti untuk Objek Tunggal

Menulis Properti Objek Konten

Bagikan melalui