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 abre 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 haya realizado 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 CR_ prefijo definidos en Cfgmgr32.h.
Observaciones
Cierre el identificador devuelto de esta función llamando 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de |
Universal |
| encabezado de |
cfgmgr32.h (incluya Cfgmgr32.h) |
| biblioteca de |
Cfgmgr32.lib |