Object Properties

Windows Portable Devices supports the following object properties.

Property VarType Description
WPD_OBJECT_BACK_REFERENCES VT_UNKNOWN An IPortableDevicePropVariantCollection of type VT_LPWSTR indicating a list of ObjectIDs. When an object is referenced by a container object, for example, an audio object referenced by a playlist, the referenced object uses this property to refer back to its container object. The audio object may refer back to the playlist object in this example.
WPD_OBJECT_CAN_DELETE VT_BOOL A Boolean value that specifies whether the given object can be deleted.
WPD_OBJECT_CONTAINER_FUNCTIONAL_OBJECT_ID VT_LPWSTR The object ID of the closest functional object that contains this object. For example, a file inside a storage functional object will have this property set to the ID of the storage functional object.
WPD_OBJECT_CONTENT_TYPE VT_CLSID A GUID that identifies the generic type of this object, for example, a document or e-mail. This can be an object type defined by Windows Portable Devices, or a custom driver content type. The device object is the only object that does not report this property.
WPD_OBJECT_DATE_AUTHORED VT_DATE A value that specifies the date and time that the content was created. This might not be the same as the creation date of the file. For example, a music file has an authoring date of when the music was recorded, but a creation date of when the WMA file was actually created on the device.
WPD_OBJECT_DATE_CREATED VT_DATE A value that specifies the date and time the object was created on the device.
WPD_OBJECT_DATE_MODIFIED VT_DATE A value that specifies the date and time the object was modified on the device.
WPD_OBJECT_FORMAT VT_CLSID A GUID identifying the format of the object data. This can be a format defined by Windows Portable Devices or a custom driver format.
WPD_OBJECT_GENERATE_THUMBNAIL_FROM_RESOURCE VT_BOOL A Boolean value that specifies whether the thumbnail image for this object should be created from the default resource data.This provides a way for objects without a thumbnail resource to provide a friendlier browsing experience. Using this flag may affect the first display response, since the application must retrieve and calculate a thumbnail image from the device; it is more efficient to provide a separate thumbnail image resource, if possible.
WPD_OBJECT_HINT_LOCATION_DISPLAY_NAME VT_LPWSTR If the given object appears as a hint location, this property indicates the hint-specific name to display instead of the object name. Drivers can specify location hints for various content types. These can be thought of as shortcuts to top-level folder objects that contain objects of the specified types. Clients that use these location hints can display a name for these shortcuts that differ from the folder's object name. If this property does not exist, the WPD_OBJECT_NAME typically is used instead.
WPD_OBJECT_ID VT_LPWSTR A string ID that uniquely identifies the object on the device. This ID need not be stored across sessions.If this property is both unique and persistent, the driver may set both WPD_OBJECT_PERSISTENT_UNIQUE_ID and WPD_OBJECT_ID to the same value.
WPD_OBJECT_IS_DRM_PROTECTED VT_BOOL A Boolean value that specifies whether the media data is DRM-protected. If not present, this is assumed to be False.
WPD_OBJECT_ISHIDDEN VT_BOOL A Boolean value that specifies whether the object should be hidden. If not present, the object is assumed to be not hidden.
WPD_OBJECT_CAN_DELETE VT_BOOL A Boolean value that specifies whether the object can be deleted.
WPD_OBJECT_ISSYSTEM VT_BOOL A Boolean value that specifies whether the object represents system data (such as a system file). If not present, the object is assumed not to be a system object.
WPD_OBJECT_KEYWORDS VT_LPWSTR String containing a list of space-delimited keywords associated with this object.
WPD_OBJECT_LANGUAGE_LOCALE VT_LPWSTR A string thati dentifies the language used by a given object. If multiple languages are contained in this object, it should identify the primary language. This property may contain either a language code, as defined in ISO-639, such as: "en". It may also contain a language-country code, which consists of a language code of two or three characters as defined in the ISO-639 standard, followed by a hyphen, then followed by a country code as defined in ISO-3166, such as: "en-US".
WPD_OBJECT_NAME VT_LPWSTR The display name for the object.
WPD_OBJECT_NON_CONSUMABLE VT_BOOL A Boolean value that specifies whether this object is intended to be understood or merely stored by the device. If this property is not present, all data is assumed to be intended for consumption.
WPD_OBJECT_ORIGINAL_FILE_NAME VT_LPWSTR A string name for the file.
WPD_OBJECT_PARENT_ID VT_LPWSTR The object ID of the parent object. The only object that can return an empty string for this value is the root device object.To modify this property, call IPortableDevice::SendCommand (WPD_COMMAND_STORAGE_MOVE).
WPD_OBJECT_PERSISTENT_UNIQUE_ID VT_LPWSTR A string ID that uniquely identifies the object on the device, similar to WPD_OBJECT_ID, but it must be stored across sessions.If the object identifier WPD_OBJECT_ID is both unique and persistent, the driver may set both WPD_OBJECT_PERSISTENT_UNIQUE_ID and WPD_OBJECT_ID to the same value.
WPD_OBJECT_REFERENCES VT_UNKNOWN An IPortableDevicePropVariantCollection containing a collection of VT_LPWSTR object IDs identifying the referenced objects. This is only required if the object is a reference object such as a folder or playlist.
WPD_OBJECT_SIZE VT_UI8 The size of the object resource data.
WPD_OBJECT_SYNC_ID VT_LPWSTR An opaque string created by a client to retain state between sessions without retaining a catalogue of connected device content.

Requirements

Requirement Value
Header
PortableDevice.h

See also

WPD Properties and Attributes