IPortableDeviceProperties ::GetPropertyAttributes, méthode (portabledeviceapi.h)

Article
03/04/2024

La méthode GetPropertyAttributes récupère les attributs d’une propriété d’objet spécifiée sur un appareil.

Syntaxe

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Paramètres

[in] pszObjectID

Pointeur vers une chaîne terminée par null qui contient l’ID d’objet de l’objet à interroger. Pour spécifier l’appareil, utilisez WPD_DEVICE_OBJECT_ID.

[in] Key

REFPROPERTYKEY qui spécifie la propriété pour laquelle interroger. Vous pouvez récupérer une liste de propriétés prises en charge en appelant GetSupportedProperties. Pour obtenir la liste des propriétés définies par les appareils portables Windows, consultez Propriétés et attributs.

[out] ppAttributes

Adresse d’une variable qui reçoit un pointeur vers une interface IPortableDeviceValues qui contient les attributs de propriété récupérés. Il s’agit de paires PROPERTYKEY/value, où propertyKEY est la propriété et le type de données value dépend de la propriété spécifique. L’appelant doit libérer cette interface lorsqu’il l’a terminé. Les attributs définis par les appareils portables Windows se trouvent dans la page Propriétés et attributs .

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	La méthode a réussi, et tous les attributs ont été récupérés avec succès.
S_FALSE	Seules quelques valeurs d’attribut peuvent être récupérées. D’autres ne peuvent pas et contiennent une valeur HRESULT de type VT_ERROR.
E_POINTER	Un argument de pointeur requis était NULL.

Remarques

Les attributs de propriété décrivent les droits d’accès, les valeurs valides et d’autres informations d’une propriété. Par exemple, une propriété peut avoir une valeur de WPD_PROPERTY_ATTRIBUTE_CAN_DELETE définie sur False pour empêcher la suppression et avoir une plage de valeurs valides stockées sous forme d’entrées individuelles.

Exemples

Pour obtenir un exemple d’utilisation de cette méthode, consultez Définition de propriétés pour un objet unique.

Configuration requise

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

Voir aussi

IPortableDeviceProperties, interface

Définition des propriétés d’un objet unique

Écriture de propriétés content-object

Partager via