Función SetupDiOpenDevRegKey (setupapi.h)
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) |