Función SetupDiOpenDeviceInterfaceRegKey (setupapi.h)

  • Artículo

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

Consulte también

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces