Fungsi SetupDiOpenDevRegKey (setupapi.h)

Artikel
03/15/2023

Fungsi SetupDiOpenDevRegKey membuka kunci registri untuk informasi konfigurasi khusus perangkat.

Sintaks

WINSETUPAPI HKEY SetupDiOpenDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType,
  [in] REGSAM           samDesired
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat yang berisi elemen informasi perangkat yang mewakili perangkat untuk membuka kunci registri.

[in] DeviceInfoData

Penunjuk ke struktur SP_DEVINFO_DATA yang menentukan elemen informasi perangkat di DeviceInfoSet.

[in] Scope

Cakupan kunci registri untuk dibuka. Cakupan menentukan di mana informasi disimpan. Cakupannya dapat berskala global atau spesifik untuk profil perangkat keras. Cakupan ditentukan oleh salah satu nilai berikut:

DICS_FLAG_GLOBAL

Buka kunci untuk menyimpan informasi konfigurasi global. Informasi ini tidak spesifik untuk profil perangkat keras tertentu. Ini membuka kunci yang berakar pada HKEY_LOCAL_MACHINE. Kunci yang tepat dibuka tergantung pada nilai parameter KeyType .

DICS_FLAG_CONFIGSPECIFIC

Buka kunci untuk menyimpan informasi konfigurasi khusus profil perangkat keras. Kunci ini berakar pada salah satu cabang khusus profil perangkat keras, bukan HKEY_LOCAL_MACHINE. Kunci yang tepat dibuka tergantung pada nilai parameter KeyType .

[in] HwProfile

Nilai profil perangkat keras, yang ditetapkan sebagai berikut:

Jika Cakupan diatur ke DICS_FLAG_CONFIGSPECIFIC, HwProfile menentukan profil perangkat keras kunci yang akan dibuka.
Jika HwProfile adalah 0, kunci untuk profil perangkat keras saat ini dibuka.
Jika Cakupan DICS_FLAG_GLOBAL, HwProfile diabaikan.

[in] KeyType

Jenis kunci penyimpanan registri untuk dibuka, yang bisa menjadi salah satu nilai berikut:

DIREG_DEV

Buka kunci perangkat keras untuk perangkat.

DIREG_DRV

Buka kunci perangkat lunak untuk perangkat.

Untuk informasi selengkapnya tentang kunci perangkat keras dan perangkat lunak perangkat, lihat Pohon dan Kunci Registri untuk Perangkat dan Driver.

[in] samDesired

Akses keamanan registri yang diperlukan untuk kunci yang diminta. Untuk informasi tentang nilai akses keamanan registri jenis REGSAM, lihat dokumentasi Microsoft Windows SDK.

Menampilkan nilai

Jika fungsi berhasil, fungsi mengembalikan handel ke kunci registri yang dibuka di mana data konfigurasi privat tentang instans perangkat ini dapat disimpan/diambil.

Jika fungsi gagal, fungsi akan mengembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Bergantung pada nilai yang diteruskan dalam parameter samDesired , mungkin perlu bagi pemanggil fungsi ini untuk menjadi anggota grup Administrator.

Tutup handel yang dikembalikan dari fungsi ini dengan memanggil RegCloseKey.

Instans perangkat yang ditentukan harus didaftarkan sebelum fungsi ini dipanggil. Namun, ketahuilah bahwa sistem operasi secara otomatis mendaftarkan instans perangkat PnP. Untuk informasi tentang cara mendaftarkan instans perangkat non-PnP, lihat SetupDiRegisterDeviceInfo.

Persyaratan


Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform	DesktopUntuk universal, panggil CM_Open_DevNode_Key
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib
DLL	Setupapi.dll
Set API	ext-ms-win-setupapi-classinstallers-l1-1-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)