Méthode IPortableDeviceCapabilities::GetSupportedFormatProperties (portabledeviceapi.h)
La méthode GetSupportedFormatProperties récupère les propriétés prises en charge par les objets d’un format spécifié sur l’appareil.
Syntaxe
HRESULT GetSupportedFormatProperties(
[in] REFGUID Format,
[out] IPortableDeviceKeyCollection **ppKeys
);
Paramètres
[in] Format
REFGUID qui spécifie le format de l’objet. Pour obtenir la liste des formats définis par les appareils portables Windows, consultez Formats d’objet.
[out] ppKeys
Adresse d’une variable qui reçoit un pointeur vers une interface IPortableDeviceKeyCollection qui contient les propriétés prises en charge pour le format spécifié. Pour obtenir la liste des propriétés définies par les appareils portables Windows, consultez Propriétés et attributs. L’appelant doit libérer cette interface lorsqu’il a terminé avec elle.
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 |
Notes
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é.
Si un objet n’a pas de valeur affectée à une propriété spécifique, ou si la propriété a été supprimée, un appareil peut ne pas signaler la propriété du tout lors de l’énumération de ses propriétés. Un autre appareil peut signaler la propriété, mais avec une chaîne vide ou une valeur de zéro. Pour éviter cette incohérence, vous pouvez appeler cette méthode pour découvrir toutes les propriétés que vous pouvez définir sur un objet spécifique.
Configuration requise
| Plateforme cible | Windows |
| En-tête | portabledeviceapi.h |
| Bibliothèque | PortableDeviceGUIDs.lib |