Propriétés des objets

Les appareils portables Windows prennent en charge les propriétés d’objet suivantes.

Propriété	VarType	Description
WPD_OBJECT_BACK_REFERENCES	VT_UNKNOWN	Un IPortableDevicePropVariantCollection de type VT_LPWSTR indiquant une liste d’ID d’objet. Lorsqu’un objet est référencé par un objet conteneur, par exemple un objet audio référencé par une playlist, l’objet référencé utilise cette propriété pour faire référence à son objet conteneur. L’objet audio peut faire référence à l’objet playlist dans cet exemple.
WPD_OBJECT_CAN_DELETE	VT_BOOL	Valeur booléenne qui spécifie si l’objet donné peut être supprimé.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID	VT_LPWSTR	ID d’objet de l’objet fonctionnel le plus proche qui contient cet objet. Par exemple, un fichier à l’intérieur d’un objet fonctionnel de stockage aura cette propriété définie sur l’ID de l’objet fonctionnel de stockage.
WPD_OBJECT_CONTENT_TYPE	VT_CLSID	GUID qui identifie le type générique de cet objet, par exemple un document ou un courrier électronique. Il peut s’agir d’un type d’objet défini par les appareils portables Windows ou d’un type de contenu de pilote personnalisé. L’objet d’appareil est le seul objet qui ne signale pas cette propriété.
WPD_OBJECT_DATE_AUTHORED	VT_DATE	Valeur qui spécifie la date et l’heure de création du contenu. Cela peut ne pas être identique à la date de création du fichier. Par exemple, un fichier musical a une date de création du moment où la musique a été enregistrée, mais une date de création de quand le fichier WMA a été créé sur l’appareil.
WPD_OBJECT_DATE_CREATED	VT_DATE	Valeur qui spécifie la date et l’heure de création de l’objet sur l’appareil.
WPD_OBJECT_DATE_MODIFIED	VT_DATE	Valeur qui spécifie la date et l’heure de modification de l’objet sur l’appareil.
WPD_OBJECT_FORMAT	VT_CLSID	GUID identifiant le format des données d’objet. Il peut s’agir d’un format défini par les appareils portables Windows ou d’un format de pilote personnalisé.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE	VT_BOOL	Valeur booléenne qui spécifie si l’image miniature de cet objet doit être créée à partir des données de ressource par défaut. Cela permet aux objets sans ressource miniature de fournir une expérience de navigation plus conviviale. L’utilisation de cet indicateur peut affecter la première réponse d’affichage, car l’application doit récupérer et calculer une image miniature à partir de l’appareil ; il est plus efficace de fournir une ressource d’image miniature distincte, si possible.
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME	VT_LPWSTR	Si l’objet donné apparaît en tant qu’emplacement d’indicateur, cette propriété indique le nom spécifique à l’indicateur à afficher à la place du nom de l’objet. Les pilotes peuvent spécifier des indicateurs d’emplacement pour différents types de contenu. Ceux-ci peuvent être considérés comme des raccourcis vers des objets de dossier de niveau supérieur qui contiennent des objets des types spécifiés. Les clients qui utilisent ces indicateurs d’emplacement peuvent afficher un nom pour ces raccourcis qui diffèrent du nom d’objet du dossier. Si cette propriété n’existe pas, le WPD_OBJECT_NAME est généralement utilisé à la place.
WPD_OBJECT_ID	VT_LPWSTR	ID de chaîne qui identifie de manière unique l’objet sur l’appareil. Cet ID n’a pas besoin d’être stocké entre les sessions. Si cette propriété est à la fois unique et persistante, le pilote peut définir WPD_OBJECT_PERSISTENT_UNIQUE_ID et WPD_OBJECT_ID sur la même valeur.
WPD_OBJECT_IS_DRM_PROTECTED	VT_BOOL	Valeur booléenne qui spécifie si les données multimédias sont protégées par DRM. S’il n’est pas présent, il est supposé avoir la valeur False.
WPD_OBJECT_ISHIDDEN	VT_BOOL	Valeur booléenne qui spécifie si l’objet doit être masqué. S’il n’est pas présent, l’objet est supposé ne pas être masqué.
WPD_OBJECT_CAN_DELETE	VT_BOOL	Valeur booléenne qui spécifie si l’objet peut être supprimé.
WPD_OBJECT_ISSYSTEM	VT_BOOL	Valeur booléenne qui spécifie si l’objet représente des données système (par exemple, un fichier système). S’il n’est pas présent, l’objet est supposé ne pas être un objet système.
WPD_OBJECT_KEYWORDS	VT_LPWSTR	Chaîne contenant une liste de mots clés délimités par des espaces associés à cet objet.
WPD_OBJECT_LANGUAGE_LOCALE	VT_LPWSTR	Chaîne quii dentifie le langage utilisé par un objet donné. Si plusieurs langues sont contenues dans cet objet, il doit identifier la langue principale. Cette propriété peut contenir un code de langage, tel que défini dans ISO-639, par exemple : « en ». Il peut également contenir un code de langue-pays, qui se compose d’un code de langue de deux ou trois caractères tel que défini dans la norme ISO-639, suivi d’un trait d’union, puis d’un code de pays tel que défini dans ISO-3166, tel que : « en-US ».
WPD_OBJECT_NAME	VT_LPWSTR	Nom d’affichage de l’objet.
WPD_OBJECT_NON_CONSUMABLE	VT_BOOL	Valeur booléenne qui spécifie si cet objet est destiné à être compris ou simplement stocké par l’appareil. Si cette propriété n’est pas présente, toutes les données sont supposées être destinées à la consommation.
WPD_OBJECT_ORIGINAL_FILE_NAME	VT_LPWSTR	Nom de chaîne pour le fichier.
WPD_OBJECT_PARENT_ID	VT_LPWSTR	ID d’objet de l’objet parent. Le seul objet qui peut retourner une chaîne vide pour cette valeur est l’objet d’appareil racine. Pour modifier cette propriété, appelez IPortableDevice::SendCommand (WPD_COMMAND_STORAGE_MOVE).
WPD_OBJECT_PERSISTENT_UNIQUE_ID	VT_LPWSTR	ID de chaîne qui identifie de manière unique l’objet sur l’appareil, comme WPD_OBJECT_ID, mais qui doit être stocké entre les sessions. Si l’identificateur d’objet WPD_OBJECT_ID est à la fois unique et persistant, le pilote peut définir à la fois WPD_OBJECT_PERSISTENT_UNIQUE_ID et WPD_OBJECT_ID sur la même valeur.
WPD_OBJECT_REFERENCES	VT_UNKNOWN	IPortableDevicePropVariantCollection contenant une collection d’ID d’objet VT_LPWSTR identifiant les objets référencés. Cela n’est requis que si l’objet est un objet de référence tel qu’un dossier ou une playlist.
WPD_OBJECT_SIZE	VT_UI8	Taille des données de ressource d’objet.
WPD_OBJECT_SYNC_ID	VT_LPWSTR	Chaîne opaque créée par un client pour conserver l’état entre les sessions sans conserver un catalogue de contenu d’appareil connecté.

Spécifications

Condition requise	Valeur
En-tête	PortableDevice.h

Voir aussi

Propriétés et attributs WPD