función CM_Get_Device_Interface_Property_Keys_ExW (cfgmgr32.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Get_Device_Interface_Property_Keys en su lugar.

La función CM_Get_Device_Interface_Property_Keys_ExW recupera una matriz de claves de propiedad de dispositivo que representan las propiedades del dispositivo que se establecen para una interfaz de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Get_Device_Interface_Property_Keys_ExW(
  [in]            LPCWSTR    pszDeviceInterface,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parámetros

[in] pszDeviceInterface

Puntero a una cadena que identifica la instancia de la interfaz de dispositivo de la que se van a recuperar las claves de propiedad.

[out, optional] PropertyKeyArray

Puntero a un búfer que recibe una matriz de valores con tipo DEVPROPKEY, donde cada valor es una clave de propiedad de dispositivo que representa una propiedad de dispositivo establecida para la interfaz del dispositivo. El puntero es opcional y puede ser NULL.

[in, out] PropertyKeyCount

Tamaño, en unidades con tipo DEVPROPKEY, del búfer PropertyKeyArray . Si PropertyKeyArray se establece en NULL, *PropertyKeyCount debe establecerse en cero. Como salida, si PropertyKeyArray no es lo suficientemente grande como para contener todos los datos de clave de propiedad, CM_Get_Device_Interface_Property_Keys_ExW devuelve el recuento de las claves, en *PropertyKeyCount.

[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

CM_Get_Device_Interface_Property_Keys_ExW forma parte del modelo de propiedades de dispositivo unificado.

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

SetupDiGetDeviceInterfacePropertyKeys