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 |