Función SetupDiOpenDevRegKey (setupapi.h)

Artículo
03/15/2023

La función SetupDiOpenDevRegKey abre una clave del Registro para la información de configuración específica del dispositivo.

Sintaxis

WINSETUPAPI HKEY SetupDiOpenDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType,
  [in] REGSAM           samDesired
);

Parámetros

[in] DeviceInfoSet

Identificador del conjunto de información del dispositivo que contiene un elemento de información del dispositivo que representa el dispositivo para el que se va a abrir una clave del Registro.

[in] DeviceInfoData

Puntero a una estructura de SP_DEVINFO_DATA que especifica el elemento de información del dispositivo en DeviceInfoSet.

[in] Scope

Ámbito de la clave del Registro que se va a abrir. El ámbito determina dónde se almacena la información. El ámbito puede ser global o específico de un perfil de hardware. El ámbito se especifica mediante uno de los valores siguientes:

DICS_FLAG_GLOBAL

Abra una clave para almacenar información de configuración global. Esta información no es específica de un perfil de hardware determinado. Se abre una clave que se basa en HKEY_LOCAL_MACHINE. La clave exacta abierta depende del valor del parámetro KeyType .

DICS_FLAG_CONFIGSPECIFIC

Abra una clave para almacenar información de configuración específica del perfil de hardware. Esta clave se basa en una de las ramas específicas del perfil de hardware, en lugar de HKEY_LOCAL_MACHINE. La clave exacta abierta depende del valor del parámetro KeyType .

[in] HwProfile

Un valor de perfil de hardware, que se establece de la siguiente manera:

Si Scope se establece en DICS_FLAG_CONFIGSPECIFIC, HwProfile especifica el perfil de hardware de la clave que se va a abrir.
Si HwProfile es 0, se abre la clave del perfil de hardware actual.
Si Scope es DICS_FLAG_GLOBAL, se omite HwProfile .

[in] KeyType

El tipo de clave de almacenamiento del Registro que se va a abrir, que puede ser uno de los siguientes valores:

DIREG_DEV

Abra una clave de hardware para el dispositivo.

DIREG_DRV

Abra una clave de software para el dispositivo.

Para obtener más información sobre las claves de hardware y software de un dispositivo, consulte Árboles y claves del Registro para dispositivos y controladores.

[in] samDesired

Acceso de seguridad del Registro necesario para la clave solicitada. 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

Si la función se realiza correctamente, devuelve un identificador a una clave del Registro abierta en la que se pueden almacenar o recuperar datos de configuración privados sobre esta instancia de dispositivo.

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 de esta función mediante una llamada a RegCloseKey.

La instancia de dispositivo especificada debe registrarse antes de llamar a esta función. Sin embargo, tenga en cuenta que el sistema operativo registra automáticamente las instancias de dispositivo PnP. Para obtener información sobre cómo registrar instancias de dispositivo que no son PnP, consulte SetupDiRegisterDeviceInfo.

Requisitos


Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	DesktopFor universal, call CM_Open_DevNode_Key
Encabezado	setupapi.h (incluya Setupapi.h)
Library	Setupapi.lib
Archivo DLL	Setupapi.dll
Conjunto de API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introducido en Windows 10, versión 10.0.14393)