Fungsi SetupDiGetClassRegistryPropertyA (setupapi.h)

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

Sintaksis

WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyA(
  [in]            const GUID *ClassGuid,
  [in]            DWORD      Property,
  [out, optional] PDWORD     PropertyRegDataType,
  [out]           PBYTE      PropertyBuffer,
  [in]            DWORD      PropertyBufferSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCSTR      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 bawah yang diinstal untuk kelas penyiapan perangkat.

SPCRP_SECURITY

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

SPCRP_SECURITY_SDS

Fungsi mengembalikan deskriptor keamanan perangkat sebagai string teks. Untuk informasi tentang string deskriptor keamanan, lihat Security Descriptor Definition Language (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 awalan REG_. Parameter ini bersifat opsional dan dapat 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

Pointer ke variabel jenis DWORD yang menerima ukuran yang diperlukan, dalam byte, dari PropertyBuffer buffer. Jika buffer PropertyBuffer terlalu kecil, dan RequiredSize tidak NULL, set fungsi 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 NULL. Jika parameter ini NULL, properti diambil dari sistem lokal.

Hati

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

Reserved

Dicadangkan, harus NULL.

Mengembalikan nilai

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

Komentar

Nota

Header setupapi.h mendefinisikan SetupDiGetClassRegistryProperty sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor 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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Windows XP dan versi Windows yang lebih baru.
Platform Target	DesktopUntuk universal, panggil CM_Get_Class_Registry_Property
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiGetDeviceRegistryProperty

SetupDiSetClassRegistryProperty

SetupDiSetDeviceRegistryProperty