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.
Windows 10, version 1703, Windows 10, version 1607, Windows 10, version 1511, Windows 10, version 1507, Windows 8.1, Windows 8, Windows 7
propertyDescription name = System.DateAcquired shellPKey = PKEY_DateAcquired formatID = 2CBAA8F5-D81F-47CA-B17A-F8D822300131 propID = 100 SearchInfo InInvertedIndex = false IsColumn = true typeInfo type = DateTime
propertyDescription name = System.DateAcquired shellPKey = PKEY_DateAcquired formatID = 2CBAA8F5-D81F-47CA-B17A-F8D822300131 propID = 100 SearchInfo IsColumn = true typeInfo type = DateTime
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.