fungsi CM_Get_Class_PropertyW (cfgmgr32.h)
Fungsi CM_Get_Class_Property mengambil properti perangkat yang diatur untuk kelas antarmuka perangkat atau kelas penyiapan perangkat.
Sintaks
CMAPI CONFIGRET CM_Get_Class_PropertyW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Parameter
[in] ClassGUID
Arahkan ke GUID yang mengidentifikasi kelas antarmuka perangkat atau kelas penyiapan perangkat untuk mengambil properti perangkat yang diatur untuk kelas perangkat. Untuk informasi tentang menentukan jenis kelas, lihat parameter ulFlags .
[in] PropertyKey
Penunjuk ke struktur DEVPROPKEY yang mewakili kunci properti perangkat dari properti kelas perangkat yang diminta.
[out] PropertyType
Penunjuk ke variabel berjenis DEVPROPTYPE yang menerima pengidentifikasi tipe data properti dari properti kelas perangkat yang diminta, di mana pengidentifikasi tipe data properti adalah bitwise ATAU antara pengidentifikasi tipe data dasar dan, jika jenis data dasar dimodifikasi, pengubah tipe data properti.
[out] PropertyBuffer
Penunjuk ke buffer yang menerima properti kelas perangkat yang diminta. CM_Get_Class_Property mengambil nilai properti yang diminta hanya jika buffer cukup besar untuk menyimpan semua data nilai properti. Penunjuk bisa NULL.
[in, out] PropertyBufferSize
Ukuran, dalam byte, dari buffer PropertyBuffer . Jika parameter PropertyBuffer diatur ke NULL, *PropertyBufferSize harus diatur ke nol. Sebagai output, jika buffer tidak cukup besar untuk menyimpan semua data nilai properti, CM_Get_Class_Property mengembalikan ukuran data, dalam byte, di *PropertyBufferSize.
[in] ulFlags
Bendera properti kelas:
CM_CLASS_PROPERTY_INSTALLER
ClassGUID menentukan kelas penyiapan perangkat. Jangan gabungkan dengan CM_CLASS_PROPERTY_INTERFACE.
CM_CLASS_PROPERTY_INTERFACE
ClassGUID menentukan kelas antarmuka perangkat. Jangan gabungkan dengan CM_CLASS_PROPERTY_INSTALLER.
Mengembalikan nilai
Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, ia mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.
Keterangan
CM_Get_Class_Property adalah bagian dari Model Properti Perangkat Terpadu.
Persyaratan
| Klien minimum yang didukung | Tersedia di Microsoft Windows Vista dan versi Windows yang lebih baru. |
| Target Platform | Universal |
| Header | cfgmgr32.h (termasuk Cfgmgr32.h) |
| Pustaka | Cfgmgr32.lib |