Función SetupDiOpenClassRegKeyExA (setupapi.h)

La función setupDiOpenClassRegKeyEx abre la clase de instalación de dispositivo clave del Registro, la clase de interfaz de dispositivo clave del Registro 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 se puede 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 del SDK de Microsoft Windows.

[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.

Cautela

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.

Observaciones

Según el valor que se pasa en el parámetro samDesired , puede 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 llamando 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
de la plataforma de destino de	Escritorio
encabezado de	setupapi.h (incluya Setupapi.h)
biblioteca de	Setupapi.lib

Consulte también

SetupDiCreateDeviceInterfaceRegKey

setupDiOpenDevRegKey