fungsi CM_Set_Class_Registry_PropertyW (cfgmgr32.h)

Artikel
02/23/2024

Fungsi CM_Set_Class_Registry_Property mengatur atau menghapus properti kelas penyiapan perangkat.

Sintaks

CMAPI CONFIGRET CM_Set_Class_Registry_PropertyW(
  [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 yang sesuai, 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.

Menampilkan 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 berukuran benar untuk jenis data REG_Xxx untuk properti yang ditentukan dalam ulProperty.

Persyaratan

Persyaratan	Nilai
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

Bagikan melalui