función CM_Open_Class_KeyW (cfgmgr32.h)
La función CM_Open_Class_Key abre la clave del Registro de clase de configuración del dispositivo, la clave del Registro de clase de interfaz de dispositivo o una subclave específica de una clase.
Sintaxis
CMAPI CONFIGRET CM_Open_Class_KeyW(
[in, optional] LPGUID ClassGuid,
[in, optional] LPCWSTR pszClassName,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkClass,
[in] ULONG ulFlags
);
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.
[in, optional] pszClassName
Reservado. Debe establecerse en NULL.
[in] samDesired
Acceso de seguridad del Registro para la clave que se va a abrir.
[in] Disposition
Especifica cómo se va a abrir la clave del Registro. Puede ser uno de los siguientes valores:
RegDisposition_OpenAlways
Abra la clave si existe. De lo contrario, cree la clave.
RegDisposition_OpenExisting
Abra la clave solo si existe.
[out] phkClass
Puntero a un HKEY que recibirá la clave abierta cuando se realice correctamente.
[in] ulFlags
Abra marcas de clave de clase:
CM_OPEN_CLASS_KEY_INSTALLER
La clave que se va a abrir es para una clase de configuración de dispositivo.
CM_OPEN_CLASS_KEY_INTERFACE
La clave que se va a abrir es para una clase de interfaz de dispositivo.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.
Comentarios
Cierre el identificador devuelto de esta función mediante una llamada a RegCloseKey.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | cfgmgr32.h (incluya Cfgmgr32.h) |
| Library | Cfgmgr32.lib |