SetupDiGetClassRegistryPropertyW (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiGetClassRegistryProperty mengambil properti untuk kelas penyiapan perangkat tertentu dari registri.

Sintaks

WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyW(
  [in]            const GUID *ClassGuid,
  [in]            DWORD      Property,
  [out, optional] PDWORD     PropertyRegDataType,
  [out]           PBYTE      PropertyBuffer,
  [in]            DWORD      PropertyBufferSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCWSTR     MachineName,
                  PVOID      Reserved
);

Parameter

[in] ClassGuid

Pointer ke GUID yang mewakili kelas penyiapan perangkat tempat properti akan diambil.

[in] Property

Nilai yang mengidentifikasi properti yang akan diambil. Ini harus menjadi salah satu nilai berikut:

SPCRP_CHARACTERISTICS

Fungsi mengembalikan bendera yang menunjukkan karakteristik perangkat untuk kelas . Untuk daftar bendera karakteristik, lihat parameter DeviceCharacteristics ke IoCreateDevice.

SPCRP_DEVTYPE

Fungsi mengembalikan nilai DWORD yang mewakili jenis perangkat untuk kelas . Untuk informasi selengkapnya, lihat Menentukan Jenis Perangkat.

SPCRP_EXCLUSIVE

Fungsi mengembalikan nilai DWORD yang menunjukkan apakah pengguna dapat memperoleh akses eksklusif ke perangkat untuk kelas ini. Nilai yang dikembalikan adalah satu jika akses eksklusif diizinkan, atau nol sebaliknya.

SPCRP_LOWERFILTERS

(Windows Vista dan yang lebih baru) Fungsi mengembalikan daftar REG_MULTI_SZ nama layanan driver filter yang lebih rendah yang diinstal untuk kelas penyiapan perangkat.

SPCRP_SECURITY

Fungsi mengembalikan pendeskripsi keamanan perangkat sebagai struktur SECURITY_DESCRIPTOR dalam format relatif mandiri (dijelaskan dalam dokumentasi Microsoft Windows SDK).

SPCRP_SECURITY_SDS

Fungsi mengembalikan 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) Fungsi mengembalikan daftar REG_MULTI_SZ nama layanan driver filter atas yang diinstal untuk kelas penyiapan perangkat.

[out, optional] PropertyRegDataType

Penunjuk ke variabel jenis DWORD yang menerima jenis data properti sebagai salah satu jenis data registri yang diawali REG_. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini NULL, SetupDiGetClassRegistryProperty tidak mengembalikan jenis data.

[out] PropertyBuffer

Penunjuk ke buffer yang menerima properti yang diminta.

[in] PropertyBufferSize

Ukuran, dalam byte, dari buffer PropertyBuffer .

[out, optional] RequiredSize

Penunjuk ke variabel jenis DWORD yang menerima ukuran yang diperlukan, dalam byte, dari buffer PropertyBuffer . Jika buffer PropertyBuffer terlalu kecil, dan RequiredSize bukan NULL, fungsi mengatur RequiredSize ke ukuran buffer minimum yang diperlukan untuk menerima properti yang diminta.

[in, optional] MachineName

Penunjuk ke string yang dihentikan NULL yang berisi nama sistem jarak jauh untuk mengambil properti kelas perangkat yang ditentukan. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini NULL, properti diambil dari 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, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan panggilan ke GetLastError.

Keterangan

Catatan

Header setupapi.h mendefinisikan SetupDiGetClassRegistryProperty 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	DesktopUntuk universal, panggil CM_Get_Class_Registry_Property
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

SetupDiSetDeviceRegistryProperty

Bagikan melalui