Función SetupDiOpenClassRegKey (setupapi.h)

  • Artículo

La función SetupDiOpenClassRegKey abre la clave del Registro de clase de instalación o la subclave de una clase específica.

Sintaxis

WINSETUPAPI HKEY SetupDiOpenClassRegKey(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired
);

Parámetros

[in, optional] ClassGuid

Puntero al GUID de la clase de instalación cuya clave 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 de instalación (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.

Valor devuelto

Si la función se realiza correctamente, 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.

Esta función no crea una clave del Registro si aún no existe.

El identificador devuelto de esta función debe cerrarse llamando a RegCloseKey.

Para abrir la clave del Registro de clase de interfaz o una subclave de clase de interfaz específica, llame a SetupDiOpenClassRegKeyEx.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino DesktopFor universal, call CM_Open_Class_Key
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib
Archivo DLL Setupapi.dll

Consulte también

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey