System.FileName

  • Article

The file name, including its extension. System.FileExtension is derived from this property.

It is possible that the item might not exist on a filesystem (that is, it may not be opened using CreateFile). Nonetheless, if the item is represented as a file and its name follows standard Win32 file-naming syntax, then the data source should emit this property. If the item is not a file, then the data source should emit this property as VT_EMPTY.

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.FileName
   shellPKey = PKEY_FileName
   formatID = 41CF5AE0-F75A-4806-BD87-59C7D9248EB9
   propID = 100
   SearchInfo
      InInvertedIndex = true
      IsColumn = true
   typeInfo
      type = String
      IsInnate = true

Windows Vista

propertyDescription
   name = System.FileName
   shellPKey = PKEY_FileName
   formatID = 41CF5AE0-F75A-4806-BD87-59C7D9248EB9
   propID = 100
   SearchInfo
      InInvertedIndex = true
      IsColumn = true
   typeInfo
      type = String
      IsInnate = true
      EnumeratedList
         UseValueForDefault = True
         enumRange
            minValue = 0
            setValue = 0
            text = 0-9
         enumRange
            minValue = A
            setValue = A
            text = A-H
         enumRange
            minValue = I
            setValue = I
            text = I-P
         enumRange
            minValue = Q
            setValue = Q
            text = Q-Z

Remarks

PKEY values are defined in Propkey.h.

The item might not exist on a filesystem (that is, it may not be opened using CreateFile), but if the item is represented as a file from the logical sense and its name follows standard Win32 file-naming syntax, then the data source should emit this property. If an item is not a file, then the value for this property is VT_EMPTY. See System.ItemNameDisplay. This has the same value as System.ParsingName for items that are provided by the Shell's file folder.

The following table lists examples of path and filename property values:

Path Property Value
c:\files\personal\hello.txt hello.txt
\\server\share\mydir\news.doc news.doc
\\server\share\numbers.xls numbers.xls
c:\Stuff\MyFolder MyFolder
[email message] VT_EMPTY
[song.wma on portable device] song.wma

 

propertyDescription

searchInfo

labelInfo

typeInfo

displayInfo

stringFormat

booleanFormat

numberFormat

dateTimeFormat

enumeratedList

drawControl

editControl

filterControl

queryControl