Compartir a través de

función CM_Open_Device_Interface_Key_ExW (cfgmgr32.h)

  • Artículo

[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 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.

[in, optional] hMachine

Identificador de máquina proporcionado por el autor de la llamada, obtenido de una llamada anterior a CM_Connect_Machine.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.
 

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_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 Convenciones para prototipos de función.

Requisitos

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

Consulte también

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey