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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
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

Consulte también

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey