fungsi CM_Set_Class_Property_ExW (cfgmgr32.h)

Artikel
08/22/2023

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

Fungsi CM_Set_Class_Property_ExW mengatur properti kelas untuk kelas penyiapan perangkat atau kelas antarmuka perangkat.

Sintaks

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

Parameter

[in] ClassGUID

Arahkan ke GUID yang mengidentifikasi kelas antarmuka perangkat atau kelas penyiapan perangkat untuk mengatur properti perangkat. Untuk informasi tentang menentukan jenis kelas, lihat parameter ulFlags .

[in] PropertyKey

Penunjuk ke struktur DEVPROPKEY yang mewakili kunci properti properti kelas perangkat yang akan diatur.

[in] PropertyType

Nilai berjenis DEVPROPTYPE yang mewakili pengidentifikasi tipe data properti untuk properti kelas perangkat. Untuk menghapus properti, atur ini ke DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Penunjuk ke buffer yang berisi nilai properti properti kelas perangkat. Jika properti atau data akan dihapus, penunjuk ini harus diatur ke NULL, dan PropertyBufferSize harus diatur ke nol.

[in] PropertyBufferSize

Ukuran, dalam byte, dari buffer PropertyBuffer . Jika PropertyBuffer diatur ke NULL, PropertyBufferSize harus diatur ke nol.

[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, optional] 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_Set_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

SetupDiSetClassProperty

Bagikan melalui