CM_Set_Class_Registry_PropertyA (cfgmgr32.h)

  • Artikel

Fungsi CM_Set_Class_Registry_Property mengatur atau menghapus properti kelas penyiapan perangkat.

Sintaks

CMAPI CONFIGRET CM_Set_Class_Registry_PropertyA(
  [in]           LPGUID   ClassGuid,
  [in]           ULONG    ulProperty,
  [in, optional] PCVOID   Buffer,
  [in]           ULONG    ulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in] ClassGuid

Penunjuk ke GUID yang mewakili kelas penyiapan perangkat untuk mengatur properti.

[in] ulProperty

Nilai jenis ULONG yang mengidentifikasi properti yang akan diatur. Nilai ini harus menjadi salah satu nilai CM_CRP_Xxx yang dijelaskan untuk parameter ulProperty dari fungsi CM_Get_Class_Registry_Property .

[in, optional] Buffer

Penunjuk ke buffer yang berisi data properti. Parameter ini bersifat opsional dan dapat diatur ke NULL. Untuk informasi selengkapnya tentang mengatur parameter ini dan parameter ulLength terkait, lihat bagian Keterangan berikut.

[in] ulLength

Nilai jenis ULONG yang menentukan ukuran, dalam byte, dari data properti.

[in] ulFlags

Dicadangkan untuk penggunaan internal saja. Harus diatur ke nol.

[in, optional] hMachine

Handel ke komputer jarak jauh untuk mengatur properti kelas penyiapan perangkat yang ditentukan. Parameter ini bersifat opsional. Jika diatur ke NULL, properti diatur pada komputer lokal.

Mengembalikan nilai

Jika operasi berhasil, CM_Set_Class_Registry_Property mengembalikan CR_SUCCESS. Jika tidak, fungsi mengembalikan salah satu kode status CR_Xxx lainnya yang ditentukan dalam Cfgmgr32.h.

Keterangan

Jika BufferNULL, ulLength harus diatur ke nol.

Jika ulLength diatur ke nol, fungsi akan menghapus properti .

Jika Buffer tidak diatur ke NULL dan ulLength tidak diatur ke nol, nilai yang disediakan harus ukuran yang benar untuk jenis data REG_Xxx untuk properti yang ditentukan dalam ulProperty.

Persyaratan

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

Lihat juga

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty