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

La méthode GetFixedPropertyAttributes récupère les attributs de propriété standard d’une propriété et d’un format spécifiés. Les attributs standard sont ceux qui ont la même valeur pour tous les objets du même format. Par exemple, un appareil peut ne pas autoriser les utilisateurs à modifier les noms de fichiers vidéo ; cet appareil retourne WPD_PROPERTY_ATTRIBUTE_CAN_WRITE avec la valeur False pour les objets au format WMV. Les attributs qui peuvent avoir des valeurs différentes pour un format, ou des attributs facultatifs, ne sont pas retournés.

Syntaxe

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

Paramètres

[in] Format

REFGUID qui spécifie le format des objets d’intérêt. Pour connaître les valeurs GUID de format, consultez Formats d’objet.

[in] Key

REFPROPERTYKEY qui spécifie la propriété dont vous souhaitez connaître les attributs. Les propriétés définies par les appareils portables Windows sont répertoriées dans Propriétés et Attributs.

[out] ppAttributes

Adresse d’une variable qui reçoit un pointeur vers une interface IPortableDeviceValues qui contient les attributs et leurs valeurs. L’appelant doit libérer cette interface lorsqu’il l’a terminé.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Remarques

Vous pouvez spécifier WPD_OBJECT_FORMAT_ALL pour le paramètre Format afin de récupérer l’ensemble complet d’attributs de propriété.

Les attributs décrivent les propriétés. Les exemples d’attributs sont WPD_PROPERTY_ATTRIBUTE_CAN_READ et WPD_PROPERTY_ATTRIBUTE_CAN_WRITE. Cette méthode ne récupère pas les attributs de ressource.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	portabledeviceapi.h
Bibliothèque	PortableDeviceGUIDs.lib

Voir aussi

IPortableDeviceCapabilities, interface

IPortableDeviceProperties ::GetPropertyAttributes