Fungsi SetupDiSetClassRegistryPropertyA (setupapi.h)

Artikel
03/01/2024

Fungsi SetupDiSetClassRegistryProperty menetapkan properti kelas perangkat tertentu di registri.

Sintaks

WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyA(
  [in]           const GUID *ClassGuid,
  [in]           DWORD      Property,
  [in, optional] const BYTE *PropertyBuffer,
  [in]           DWORD      PropertyBufferSize,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

Parameter

[in] ClassGuid

Penunjuk ke GUID yang mengidentifikasi kelas perangkat tempat properti akan diatur.

[in] Property

Nilai yang mengidentifikasi properti yang akan ditetapkan, yang harus merupakan salah satu dari berikut ini:

SPCRP_CHARACTERISTICS

Pemanggil menyediakan bendera yang menentukan karakteristik perangkat untuk kelas . Untuk daftar bendera karakteristik, lihat parameter DeviceCharacteristicsIoCreateDevice. Karakteristik perangkat harus diatur ketika kelas perangkat diinstal dan tidak boleh diubah setelah kelas perangkat diinstal.

SPCRP_DEVTYPE

Penelepon memasok jenis perangkat untuk kelas . Untuk informasi selengkapnya, lihat Menentukan Jenis Perangkat. Jenis perangkat harus diatur ketika kelas perangkat diinstal dan tidak boleh diubah setelah kelas perangkat diinstal.

SPCRP_EXCLUSIVE

Pemanggil menyediakan nilai DWORD yang menentukan apakah pengguna dapat memperoleh akses eksklusif ke perangkat untuk kelas ini. Nilai yang disediakan adalah 1 jika akses eksklusif diizinkan, atau nol sebaliknya. Pengaturan eksklusif untuk perangkat harus diatur saat kelas perangkat diinstal dan tidak boleh diubah setelah kelas perangkat diinstal.

SPCRP_LOWERFILTERS

(Windows Vista dan yang lebih baru) Penelepon menyediakan daftar REG_MULTI_SZ nama layanan driver filter yang lebih rendah yang diinstal untuk kelas penyiapan perangkat. Untuk informasi selengkapnya tentang cara menginstal driver filter kelas, lihat Menginstal Driver Filter dan Bagian INF ClassInstall32.

SPCRP_SECURITY

Pemanggil menyediakan deskriptor keamanan perangkat sebagai struktur SECURITY_DESCRIPTOR dalam format relatif mandiri (dijelaskan dalam dokumentasi Microsoft Windows SDK).

SPCRP_SECURITY_SDS

Pemanggil menyediakan pendeskripsi keamanan perangkat sebagai string teks. Untuk informasi tentang string deskriptor keamanan, lihat Bahasa Definisi Deskriptor Keamanan (Windows). Untuk informasi tentang format string deskriptor keamanan, lihat Bahasa Definisi Deskriptor Keamanan (Windows).

SPCRP_UPPERFILTERS

(Windows Vista dan yang lebih baru) Pemanggil menyediakan daftar REG_MULTI_SZ nama layanan driver filter atas yang diinstal untuk kelas penyiapan perangkat. Untuk informasi selengkapnya tentang cara menginstal driver filter kelas, lihat Menginstal Driver Filter dan Bagian INF ClassInstall32.

[in, optional] PropertyBuffer

Penunjuk ke buffer yang memasok properti yang ditentukan. Parameter ini bersifat opsional dan dapat berupa NULL.

[in] PropertyBufferSize

Ukuran, dalam byte, dari buffer PropertyBuffer .

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang berisi nama sistem jarak jauh untuk mengatur properti kelas perangkat yang ditentukan. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini NULL, properti diatur pada nama sistem lokal.

Perhatian

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

Reserved

Dicadangkan, harus NULL.

Nilai kembali

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ia mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Keterangan

Pemanggil fungsi ini harus menjadi anggota grup Administrator.

Untuk menentukan jenis data untuk properti kelas perangkat, panggil SetupDiGetClassRegistryProperty.

Catatan

Header setupapi.h mendefinisikan SetupDiSetClassRegistryProperty sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty

Bagikan melalui