Funzione SetupDiOpenDeviceInterfaceRegKey (setupapi.h)

La funzione SetupDiOpenDeviceInterfaceRegKey apre la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'interfaccia del dispositivo.

Sintassi

WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved,
  [in] REGSAM                    samDesired
);

Parametri

[in] DeviceInfoSet

Puntatore a un set di informazioni sul dispositivo contenente l'interfaccia del dispositivo per la quale aprire una sottochiave del Registro di sistema.

[in] DeviceInterfaceData

Puntatore a una struttura SP_DEVICE_INTERFACE_DATA che specifica l'interfaccia del dispositivo. Questo puntatore può essere restituito da SetupDiCreateDeviceInterface o SetupDiEnumDeviceInterfaces.

Reserved

Riservato. Deve essere zero.

[in] samDesired

Accesso di sicurezza del Registro di sistema richiesto alla sottochiave del Registro di sistema. Per informazioni sui valori di accesso alla sicurezza del Registro di sistema di tipo REGSAM, vedere la documentazione di Microsoft Windows SDK.

Valore restituito

SetupDiOpenDeviceInterfaceRegKey restituisce un handle alla chiave del Registro di sistema aperta. Se la funzione ha esito negativo, restituisce INVALID_HANDLE_VALUE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

A seconda del valore passato nel parametro samDesired , potrebbe essere necessario che il chiamante di questa funzione sia membro del gruppo Administrators.

Chiudere l'handle restituito dalla funzione chiamando RegCloseKey.

Requisiti

Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	DesktopFor universal, chiamare CM_Open_Device_Interface_Key
Intestazione	setupapi.h (include Setupapi.h)
Libreria	Setupapi.lib
DLL	Setupapi.dll

Vedi anche

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces