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