Función SetupDiOpenClassRegKeyExA (setupapi.h)
La función SetupDiOpenClassRegKeyEx abre la clave del Registro de la clase de instalación del dispositivo , la clave del Registro de clase de interfaz de dispositivo o la subclave de una clase específica. Esta función abre la clave especificada en el equipo local o en un equipo remoto.
Sintaxis
WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired,
[in] DWORD Flags,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parámetros
[in, optional] ClassGuid
Puntero al GUID de la clase cuya clave del Registro se va a abrir. Este parámetro es opcional y puede ser NULL. Si este parámetro es NULL, se abre la raíz del árbol de clases (HKLM\SYSTEM\CurrentControlSet\Control\Class).
[in] samDesired
Acceso de seguridad del Registro para la clave que se va a abrir. Para obtener información sobre los valores de acceso de seguridad del Registro de tipo REGSAM, consulte la documentación de Microsoft Windows SDK.
[in] Flags
Tipo de clave del Registro que se va a abrir, que se especifica mediante una de las siguientes opciones:
DIOCR_INSTALLER
Abra una clave de clase de instalación. Si ClassGuid es NULL, abra la clave raíz de la rama del instalador de clase.
DIOCR_INTERFACE
Abra una clave de clase de interfaz. Si ClassGuid es NULL, abra la clave raíz de la rama de clase de interfaz.
[in, optional] MachineName
Opcionalmente, apunta a una cadena que contiene el nombre de un equipo remoto en el que se va a abrir la clave especificada.
Precaución
No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
Reserved
Reservado. Debe ser NULL.
Valor devuelto
SetupDiOpenClassRegKeyEx devuelve un identificador a una clave del Registro abierta donde se puede almacenar o recuperar información sobre esta clase de instalación.
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.
SetupDiOpenClassRegKeyEx no crea una clave del Registro si aún no existe.
Los autores de llamadas de esta función deben cerrar el identificador devuelto de esta función mediante una llamada a RegCloseKey.
Nota
El encabezado setupapi.h define SetupDiOpenClassRegKeyEx como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |