Función SetupDiOpenDeviceInterfaceRegKey (setupapi.h)
La función SetupDiOpenDeviceInterfaceRegKey abre la subclave del Registro que usan las aplicaciones y los controladores para almacenar información específica de una interfaz de dispositivo.
Sintaxis
WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired
);
Parámetros
[in] DeviceInfoSet
Puntero a un conjunto de información del dispositivo que contiene la interfaz de dispositivo para la que se va a abrir una subclave del Registro.
[in] DeviceInterfaceData
Puntero a una estructura SP_DEVICE_INTERFACE_DATA que especifica la interfaz del dispositivo. Este puntero se puede devolver mediante SetupDiCreateDeviceInterface o SetupDiEnumDeviceInterfaces.
Reserved
Reservado. Debe ser cero.
[in] samDesired
Acceso de seguridad del Registro solicitado a la subclave del Registro. Para obtener información sobre los valores de acceso de seguridad del Registro de tipo REGSAM, consulte la documentación de Microsoft Windows SDK.
Valor devuelto
SetupDiOpenDeviceInterfaceRegKey devuelve un identificador a la clave del Registro abierta. Si se produce un error en la función, devuelve INVALID_HANDLE_VALUE. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Según el valor que se pasa en el parámetro samDesired , podría ser necesario que el autor de la llamada de esta función sea miembro del grupo Administradores.
Cierre el identificador devuelto por la función llamando a RegCloseKey.
Requisitos
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | DesktopFor universal, call CM_Open_Device_Interface_Key |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |