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 |