Fungsi SetupDiOpenDeviceInterfaceRegKey (setupapi.h)
Fungsi SetupDiOpenDeviceInterfaceRegKey membuka subkunjung registri yang digunakan oleh aplikasi dan driver untuk menyimpan informasi yang khusus untuk antarmuka perangkat.
Sintaks
WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired
);
Parameter
[in] DeviceInfoSet
Penunjuk ke set informasi perangkat yang berisi antarmuka perangkat untuk membuka subkunci registri.
[in] DeviceInterfaceData
Penunjuk ke struktur SP_DEVICE_INTERFACE_DATA yang menentukan antarmuka perangkat. Penunjuk ini dapat dikembalikan oleh SetupDiCreateDeviceInterface atau SetupDiEnumDeviceInterfaces.
Reserved
Dicadangkan. Harus nol.
[in] samDesired
Akses keamanan registri yang diminta ke subkuntang registri. Untuk informasi tentang nilai akses keamanan registri jenis REGSAM, lihat dokumentasi Microsoft Windows SDK.
Mengembalikan nilai
SetupDiOpenDeviceInterfaceRegKey mengembalikan handel ke kunci registri yang dibuka. 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 dengan memanggil RegCloseKey.
Persyaratan
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | DesktopUntuk universal, panggil CM_Open_Device_Interface_Key |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |
| DLL | Setupapi.dll |