Fungsi SetupDiOpenDeviceInterfaceRegKey (setupapi.h)

  • Artikel

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

Lihat juga

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces