Compartir a través de

función CM_Get_Device_Interface_Property_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 en su lugar.

La función CM_Get_Device_Interface_Property_ExW recupera una propiedad de dispositivo establecida para una interfaz de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Get_Device_Interface_Property_ExW(
  [in]           LPCWSTR          pszDeviceInterface,
  [in]           const DEVPROPKEY *PropertyKey,
  [out]          DEVPROPTYPE      *PropertyType,
  [out]          PBYTE            PropertyBuffer,
  [in, out]      PULONG           PropertyBufferSize,
  [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 va a recuperar la propiedad.

[in] PropertyKey

Puntero a una estructura DEVPROPKEY que representa la clave de propiedad de interfaz de dispositivo de la propiedad de interfaz de dispositivo que se va a recuperar.

[out] PropertyType

Puntero a una variable con tipo DEVPROPTYPE que recibe el identificador de tipo de datos de propiedad de la propiedad de interfaz de dispositivo solicitada. El identificador property-data-type es un or bit a bit entre un identificador de tipo de datos base y, si se modifica el tipo de datos base, un modificador property-data-type.

[out] PropertyBuffer

Puntero a un búfer que recibe la propiedad de interfaz de dispositivo solicitada. CM_Get_Device_Interface_Property_ExW recupera la propiedad solicitada solo si el búfer es lo suficientemente grande como para contener todos los datos de valor de propiedad. El puntero puede ser NULL.

[in, out] PropertyBufferSize

Tamaño, en bytes, del búfer PropertyBuffer . Si PropertyBuffer se establece en NULL, *PropertyBufferSize debe establecerse en cero. Como salida, si el búfer no es lo suficientemente grande como para contener todos los datos de valor de propiedad, CM_Get_Device_Interface_Property_ExW devuelve el tamaño de los datos, en bytes, en *PropertyBufferSize.

[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_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
Archivo DLL CfgMgr32.dll

Consulte también

CM_Connect_Machine

SetupDiGetDeviceInterfaceProperty