función CM_Open_Device_Interface_Key_ExW (cfgmgr32.h)
[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Open_Device_Interface_Key en su lugar.]
La función CM_Open_Device_Interface_Key_ExW 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_Key_ExW(
[in] LPCWSTR pszDeviceInterface,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkDeviceInterface,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
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.
[in, optional] hMachine
Identificador de máquina proporcionado por el autor de la llamada, obtenido de una llamada anterior a CM_Connect_Machine.
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_Ex 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 10 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
cfgmgr32.h (incluya Cfgmgr32.h) |
| biblioteca de |
Cfgmgr32.lib |