Fungsi SetupDiOpenDevRegKey (setupapi.h)
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) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk