对象属性

Windows 可移植设备支持以下对象属性。

属性	VarType	说明
WPD_OBJECT_BACK_REFERENCES	VT_UNKNOWN	类型的 IPortableDevicePropVariantCollection VT_LPWSTR，指示 ObjectID 的列表。 当容器对象（例如播放列表引用的音频对象）引用对象时，被引用的对象使用此属性引用回其容器对象。 在此示例中，音频对象可以引用回播放列表对象。
WPD_OBJECT_CAN_DELETE	VT_BOOL	一个布尔值，指定是否可以删除给定对象。
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID	VT_LPWSTR	包含此对象的最近功能对象的对象 ID。 例如，存储功能对象中的文件会将此属性设置为存储功能对象的 ID。
WPD_OBJECT_CONTENT_TYPE	VT_CLSID	标识此对象的泛型类型的 GUID ，例如文档或电子邮件。 这可以是 Windows 可移植设备定义的对象类型，也可以是自定义驱动程序内容类型。 设备对象是唯一不报告此属性的对象。
WPD_OBJECT_DATE_AUTHORED	VT_DATE	一个 值，该值指定内容的创建日期和时间。 这可能与文件的创建日期不同。 例如，音乐文件的创作日期为录制音乐的时间，但创建日期为实际在设备上创建 WMA 文件的时间。
WPD_OBJECT_DATE_CREATED	VT_DATE	一个 值，该值指定在设备上创建对象的日期和时间。
WPD_OBJECT_DATE_MODIFIED	VT_DATE	一个 值，该值指定在设备上修改对象的日期和时间。
WPD_OBJECT_FORMAT	VT_CLSID	标识对象数据格式的 GUID 。 这可以是 Windows 可移植设备定义的格式 ，也可以是自定义驱动程序格式。
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE	VT_BOOL	一个布尔值，指定是否应从默认资源数据创建此对象的缩略图图像。这为没有缩略图资源的对象提供了一种更友好的浏览体验的方法。 使用此标志可能会影响第一个显示响应，因为应用程序必须从设备检索和计算缩略图图像;如果可能，提供单独的缩略图资源会更有效。
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME	VT_LPWSTR	如果给定对象显示为提示位置，则此属性指示要显示的特定于提示的名称，而不是对象名称。 驱动程序可以为各种内容类型指定位置提示。 可以将它们视为包含指定类型对象的顶级文件夹对象的快捷方式。 使用这些位置提示的客户端可以显示与文件夹对象名称不同的这些快捷方式的名称。 如果此属性不存在，则通常改用 WPD_OBJECT_NAME 。
WPD_OBJECT_ID	VT_LPWSTR	唯一标识设备上的 对象的字符串 ID。 无需跨会话存储此 ID。如果此属性既唯一又持久，驱动程序可能会将 WPD_OBJECT_PERSISTENT_UNIQUE_ID 和 WPD_OBJECT_ID 设置为相同的值。
WPD_OBJECT_IS_DRM_PROTECTED	VT_BOOL	一个布尔值，指定媒体数据是否受 DRM 保护。 如果不存在，则假定为 False。
WPD_OBJECT_ISHIDDEN	VT_BOOL	一个布尔值，指定是否应隐藏对象。 如果不存在，则假定对象未隐藏。
WPD_OBJECT_CAN_DELETE	VT_BOOL	一个布尔值，指定是否可以删除对象。
WPD_OBJECT_ISSYSTEM	VT_BOOL	一个布尔值，指定对象是否表示系统数据 (（如系统文件) ）。 如果不存在，则假定对象不是系统对象。
WPD_OBJECT_KEYWORDS	VT_LPWSTR	包含与此对象关联的空格分隔关键字列表的字符串。
WPD_OBJECT_LANGUAGE_LOCALE	VT_LPWSTR	表示给定对象使用的语言的字符串。 如果此对象中包含多种语言，则它应标识主要语言。 此属性可能包含 ISO-639 中定义的任一语言代码，例如：“en”。 它还可能包含语言国家/地区代码，该代码由 ISO-639 标准中定义的两个或三个字符的语言代码组成，后跟连字符，后跟 ISO-3166 中定义的国家/地区代码，例如：“en-US”。
WPD_OBJECT_NAME	VT_LPWSTR	对象的显示名称。
WPD_OBJECT_NON_CONSUMABLE	VT_BOOL	一个布尔值，指定此对象是旨在由设备理解还是仅存储。 如果此属性不存在，则假定所有数据都用于使用。
WPD_OBJECT_ORIGINAL_FILE_NAME	VT_LPWSTR	文件的字符串名称。
WPD_OBJECT_PARENT_ID	VT_LPWSTR	父对象的对象 ID。 唯一可以为此值返回空字符串的对象是根设备对象。若要修改此属性，请调用 IPortableDevice：：SendCommand (WPD_COMMAND_STORAGE_MOVE) 。
WPD_OBJECT_PERSISTENT_UNIQUE_ID	VT_LPWSTR	唯一标识设备上的对象的字符串 ID，类似于 WPD_OBJECT_ID，但它必须跨会话存储。如果 对象标识符WPD_OBJECT_ID 唯一且持久，驱动程序可能会将 WPD_OBJECT_PERSISTENT_UNIQUE_ID 和 WPD_OBJECT_ID 设置为相同的值。
WPD_OBJECT_REFERENCES	VT_UNKNOWN	一个 IPortableDevicePropVariantCollection，其中包含标识所引用对象的VT_LPWSTR对象 ID 的集合。 仅当对象是引用对象（如文件夹或播放列表）时，才需要这样做。
WPD_OBJECT_SIZE	VT_UI8	对象资源数据的大小。
WPD_OBJECT_SYNC_ID	VT_LPWSTR	客户端创建的不透明字符串，用于在会话之间保留状态，而不保留连接的设备内容目录。

要求

要求	值
标头	PortableDevice.h

另请参阅

WPD 属性和属性