Método IPortableDeviceCapabilities::GetFixedPropertyAttributes (portabledeviceapi.h)

El método GetFixedPropertyAttributes recupera los atributos de propiedad estándar de una propiedad y formato especificados. Los atributos estándar son aquellos que tienen el mismo valor para todos los objetos del mismo formato. Por ejemplo, un dispositivo podría no permitir que los usuarios modifiquen nombres de archivo de vídeo; este dispositivo devolvería WPD_PROPERTY_ATTRIBUTE_CAN_WRITE con un valor false para objetos con formato WMV. Los atributos que pueden tener valores diferentes para un formato, o atributos opcionales, no se devuelven.

Sintaxis

HRESULT GetFixedPropertyAttributes(
  [in]  REFGUID               Format,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Parámetros

[in] Format

REFGUID que especifica el formato de los objetos de interés. Para conocer los valores guid de formato, consulte Formatos de objeto.

[in] Key

REFPROPERTYKEY que especifica la propiedad de la que desea conocer los atributos. Las propiedades definidas por dispositivos portátiles de Windows se enumeran en Propiedades y atributos.

[out] ppAttributes

Dirección de una variable que recibe un puntero a una interfaz IPortableDeviceValues que contiene los atributos y sus valores. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

Puede especificar WPD_OBJECT_FORMAT_ALL para el parámetro Format para recuperar el conjunto completo de atributos de propiedad.

Los atributos describen las propiedades. Los atributos de ejemplo son WPD_PROPERTY_ATTRIBUTE_CAN_READ y WPD_PROPERTY_ATTRIBUTE_CAN_WRITE. Este método no recupera atributos de recursos.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceCapabilities (Interfaz)

IPortableDeviceProperties::GetPropertyAttributes