System.FileName

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.

propertyDescription
   name = System.FileName
   shellPKey = PKEY_FileName
   formatID = 41CF5AE0-F75A-4806-BD87-59C7D9248EB9
   propID = 100
   searchInfo
      inInvertedIndex = true
      isColumn = true
      isColumnSparse = true
      columnIndexType = OnDisk
      maxSize = 128
      mnemonics = filename
   labelInfo
      label = Filename
      sortDescription
      invitationText = Specify filename
      hideLabel = false
   typeInfo
      type = String
      groupingRange = Alphanumeric
      isInnate = true
      canBePurged
      multipleValues = false
      isGroup = false
      aggregationType = Default
      isTreeProperty = false
      isViewable = true
      isQueryable (Vista) = true
      includeInFullTextQuery (Vista) = false
      searchRawValue (Windows 7) = true
      conditionType = String
      defaultOperation = Equal
   aliasInfo
      sortByAlias = None
      additionalSortByAliases = None
   displayInfo
      defaultColumnWidth = 24
      displayType
      alignment = Left
      relativeDescriptionType = General
      defaultSortDirection = Ascending
      stringFormat
         formatAs = FileName
      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 = Q
            setValue = Q
            text = Q-Z
      drawControl
         control = Default
      editControl
         control = Default
      filterControl
         control = Default
      queryControl
         control = Default

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:

PathProperty Value
c:\files\personal\hello.txthello.txt
\\server\share\mydir\news.docnews.doc
\\server\share\numbers.xlsnumbers.xls
c:\Stuff\MyFolderMyFolder
[email message]VT_EMPTY
[song.wma on portable device]song.wma

 

Related topics

propertyDescription
searchInfo
labelInfo
typeInfo
displayInfo
stringFormat
booleanFormat
numberFormat
dateTimeFormat
enumeratedList
drawControl
editControl
filterControl
queryControl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft