The acquisition date of the file or media. This property is related to a particular user or group of users. For example, this data is used as the main sorting axis for the virtual folder New Music, which enables people to browse the latest additions to their collection.
propertyDescription name = System.DateAcquired shellPKey = PKEY_DateAcquired formatID = 2CBAA8F5-D81F-47CA-B17A-F8D822300131 propID = 100 searchInfo inInvertedIndex = true isColumn = true isColumnSparse = true columnIndexType = OnDisk maxSize = 128 mnemonics = acquired labelInfo label = Date acquired sortDescription invitationText = Specify date and time acquired hideLabel = false typeInfo type = DateTime groupingRange = Discrete isInnate = false multipleValues = false isGroup = false aggregationType = Default isTreeProperty = false isViewable = true isQueryable = true includeInFullTextQuery = false conditionType = String defaultOperation = Equal aliasInfo sortByAlias = None additionalSortByAliases = None displayInfo defaultColumnWidth = 20 displayType alignment = Left relativeDescriptionType = General defaultSortDirection = Ascending stringFormat formatAs = General booleanFormat formatAs = YesNo numberFormat formatAs = General formatDurationAs = hh:mm:ss dateTimeFormat formatAs = General formatTimeAs = ShortTime formatDateAs = ShortDate enumeratedList defaultText useValueForDefault = False enum value text enumRange minValue setValue text drawControl control = Default editControl control = Default filterControl control = Default queryControl control = Default
PKEY values are defined in Propkey.h.
DateAcquired is stored as a value in the main stream of the file, but it may not always be present. In those instances, the acquisition date can be approximated based on other known dates for the content. The metadata handler should use a set of rules to determine the date to return. The following example demonstrates this for music files.
- For purchased music, the file's creation time should be used if no acquired date is present. However, the download provider should set the DateAcquired property in the file.
- For music files that the user or group "ripped" (copying music or video from a CD or DVD to a hard disk), the acquisition date should be the date that action took place. For instance, the WM/EncodingTime attribute.
- For music copied from another location, the file's creation time should be used as the acquisition date.