función CM_Open_Class_KeyW (cfgmgr32.h)

  • Artículo

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

Consulte también

CM_Delete_Class_Key

SetupDiOpenClassRegKeyEx