fungsi CM_Get_Class_Property_ExW (cfgmgr32.h)

  • Artikel

[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. Silakan gunakan CM_Get_Class_Property sebagai gantinya.]

Fungsi CM_Get_Class_Property_ExW mengambil properti perangkat yang diatur untuk kelas antarmuka perangkat atau kelas penyiapan perangkat.

Sintaks

CMAPI CONFIGRET CM_Get_Class_Property_ExW(
  [in]      LPCGUID          ClassGUID,
  [in]      const DEVPROPKEY *PropertyKey,
  [out]     DEVPROPTYPE      *PropertyType,
  [out]     PBYTE            PropertyBuffer,
  [in, out] PULONG           PropertyBufferSize,
  [in]      ULONG            ulFlags,
  [in]      HMACHINE         hMachine
);

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_ExW 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_ExW 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.

[in] hMachine

Handel mesin yang disediakan penelepon, diperoleh dari panggilan sebelumnya ke CM_Connect_Machine.

Catatan Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsi ini telah dihapus.
 

Menampilkan 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_ExW adalah bagian dari Model Properti Perangkat Terpadu.

Persyaratan

   
Klien minimum yang didukung Tersedia di Microsoft Windows 10 dan versi Windows yang lebih baru.
Target Platform Desktop
Header cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka Cfgmgr32.lib

Lihat juga

CM_Connect_Machine

SetupDiGetClassProperty

SetupDiGetClassPropertyEx