función CM_Open_Device_Interface_KeyA (cfgmgr32.h)

La función CM_Open_Device_Interface_Key abre la subclave del Registro que usan las aplicaciones y los controladores para almacenar información específica de una interfaz de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
  [in]  LPCSTR         pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

Parámetros

[in] pszDeviceInterface

Puntero a una cadena que identifica la instancia de interfaz de dispositivo para la que se va a abrir la subclave del Registro.

[in] samDesired

Acceso de seguridad del Registro solicitado a la subclave del Registro.

[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] phkDeviceInterface

Puntero a un HKEY que recibirá la clave abierta cuando se realice correctamente.

[in] ulFlags

Reservado. Debe establecerse en cero.

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.

Nota

El encabezado cfgmgr32.h define CM_Open_Device_Interface_Key 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows Vista y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib

Consulte también

SetupDiOpenDeviceInterfaceRegKey