Appendix

Top  Previous  Next

FileInfo object

The fileInfo object is a client-side object that is passed to certain events and also via the fileInfoList property

             

Property

Type

Description

name

string

File/Folder name

type

string

Indicates if file or folder information. Possible values are FileInfo or DirectoryInfo

lastAccessTime

date

Date file was last accessed

lastWriteTime

date

Date file was last written to

creationTime

date

Date the file was created

files

number

Number of files in folder (folders only)

directories

number

Number of sub-folders in folder (folders only)

extension

string

File extension (files only)

length

number

Size of file in bytes (files only)

 

Column Types

File System Column Types

Column Type

Description

Icon

Icon representing the file type in the column

Name

File name

Size

File size

DateCreated

Date the file was created

Type

File type (extension)

DateLastModified

Date the file was last modified

DateLastAccessed

Date the file was last accessed

Thumbnail

Thumbnail (for image files only)

Folder

Parent folder

Windows Search Column Types

 

Column Type

Description

System

System_AcquisitionID

A hash value that indicates the acquisition session.

System_ApplicationName

The name of the application that created this file or item. Do not use version numbers to identify the application's specific version.

System_Author

Represents the author or authors of the document.

System_Capacity

The amount of total storage space, expressed in bytes. This property is mainly used to indicate the capacity of storage media such as hard drives.

System_Category

Deprecated. The category that can be assigned to an item such as a document or file. This property is inherited from OLE document properties and is deprecated for Windows Vista. Keywords should be used instead. Older code treats this property as VT_LPSTR.

System_Comment

The comment attached to a file, typically added by a user.

System_Company

The company or publisher.

System_ComputerName

The name of the computer where the item or file is located. This property is automatically populated by Microsoft Windows and should not be used for anything other than its intended purpose.

System_ContainedItems

A list of the type of content in the item. This value is represented as a vector array of GUIDs, where each GUID represents a certain type, such as URLs or attachments.

System_ContentStatus


System_ContentType


System_Copyright

Represents the author or authors of the document.

System_DateAccessed

Indicates the last time the item was accessed. The Indexing Service friendly name is "access".

System_DateAcquired


System_DateArchived

The date the file item was last archived.

System_DateCompleted


System_DateCreated

The date and time the item was created on the file system where it is currently located. This property is automatically promoted by the file system. The Indexing Service friendly name is "create".

System_DateImported

The date and time the file was imported into a private application database. For example, this property can be used when a photo is imported into a photo database. This property is not the same as

System_DateModified

The date and time of the last modification to the item. The Indexing Service friendly name is 'write'.

System_DueDate


System_EndDate


System_FileAllocationSize


System_FileAttributes

The attributes of the item. These are equivalent to the values recognized in the

System_FileCount


System_FileDescription

Represents the author or authors of the document.

System_FileExtension

The file extension of the file-based item, including the leading period.

System_FileFRN

The unique file ID, also known as the File Reference Number. For a given file, this is the same value as the

System_FileName

The file name, including its extension.

System_FileOwner

The owner of the file, as known by the file system.

System_FileVersion


System_FindData

Contains the

System_FlagColor


System_FlagColorText

The user-friendly form of

System_FlagStatus

The status of a flag. Values: (0=none 1=white 2=Red).

System_FlagStatusText

Represents the author or authors of the document.

System_FreeSpace

The amount of free space in a volume, in bytes.

System_Identity


System_Importance


System_ImportanceText

The user-friendly form of

System_IsAttachment

Identifies whether the item is an attachment.

System_IsDeleted


System_IsEncrypted


System_IsFlagged


System_IsFlaggedComplete


System_IsIncomplete

Identifies whether the message was completely received. This value is used with some error conditions.

System_IsRead

Identifies whether the item has been read.

System_IsSendToTarget

Indicates whether an item is a valid SendTo target. This information is provided by certain Shell folders.

System_IsShared

Indicates whether the item is shared.

System_ItemAuthors

Generic list of authors associated with an item. For example, the artist name for a music track is the item author.

System_ItemDate

The primary date of interest for an item. In the case of photos, for example, this property maps to

System_ItemFolderNameDisplay

The user-friendly display name of an item's parent folder.

System_ItemFolderPathDisplay

The user-friendly display path of an item's parent folder.

System_ItemFolderPathDisplayNarrow


System_ItemName

The base name of the

System_ItemNameDisplay

The display name in "most complete" form. It is the unique representation of the item name most appropriate for end users.

System_ItemNamePrefix

The prefix of an item, used for e-mail messages where the subject begins with the prefix "Re:".

System_ItemParticipants

The generic list of people associated with and contributing to an item. For example, this is the combination of people in the To list, Cc list, and the sender of an e-mail message.

System_ItemPathDisplay

The user-friendly display path to the item.

System_ItemPathDisplayNarrow

The user-friendly display path to the item.

System_ItemType

The canonical type of the item.

System_ItemTypeText

The user-friendly type name of the item. This value is not intended to be programmatically parsed.

System_ItemUrl

Represents a well-formed URL that points to the item.

System_Keywords

The set of keywords (also known as "tags") assigned to the item.

System_Kind

Maps extensions to various .Search folders.

System_KindText

The user-friendly form of

System_Language

The primary language of the file, particularly if that file is a document.

System_MileageInformation


System_MIMEType

The MIME type.

System_Null


System_OfflineAvailability


System_OfflineStatus


System_OriginalFileName


System_ParentalRating

The parental rating stored in a format typically determined by the organization named in

System_ParentalRatingReason

Explains file ratings. For example, "Violence, Foul Language" for a rating of R under the MPAA rating system.

System_ParentalRatingsOrganization

The name of the organization whose rating system is used for

System_ParsingBindContext

Used to get the

System_ParsingName

The Shell namespace name of an item relative to a parent folder.

System_ParsingPath

The Shell namespace path to the item.

System_PerceivedType

The perceived file type based on its canonical type.

System_PercentFull

The amount of space filled, as a percentage.

System_Priority


System_PriorityText

The user-friendly form of

System_Project


System_ProviderItemID


System_Rating

A rating system that uses integer values between 0 and 99. This is the rating system used by the Windows Vista Shell.

System_RatingText

The user-friendly form of

System_Sensitivity


System_SensitivityText

The user-friendly form of

System_SFGAOFlags


System_SharedWith

Indicates who the item is shared with.

System_ShareUserRating


System_Shell_OmitFromView

Omits an item from Shell views.

System_SimpleRating

A rating system that uses a range of integer values between 0 and 5.

System_Size

The system-provided file system size of the item, in bytes.

System_SoftwareUsed


System_SourceItem


System_StartDate


System_Status

Generic status information applicable to the item.

System_Subject

The subject of a document. This property maps to the OLE document property

System_Thumbnail

Represents the thumbnail in VT_CF format.

System_ThumbnailCacheId

A unique value used as a key to cache thumbnails. The value changes when the name, volume, or data modified of an item changes.

System_ThumbnailStream

Data that represents the thumbnail in VT_STREAM format, supported by Microsoft Windows GDI+ and Windows codecs such as .jpg and .png.

System_Title

Specifies how to configure the Microsoft Windows search engine with respect to a given property definition. If no

System_TotalFileSize


System_Trademarks

The trademark associated with the item, in a string format.

Audio

Audio_ChannelCount

Indicates the channel count for the audio file. Values: 1 (mono), 2 (stereo).

Audio_Compression


Audio_EncodingBitrate

Indicates the average data rate for the audio file in bits per second.

Audio_Format

Indicates the format of the audio file.

Audio_IsVariableBitRate


Audio_PeakValue


Audio_SampleRate

Indicates the sample rate for the audio file in samples per second.

Audio_SampleSize

Indicates the sample size for the audio file in bits per sample.

Audio_StreamName


Audio_StreamNumber


Document

Document_ByteCount


Document_CharacterCount


Document_ClientID


Document_Contributor


Document_DateCreated

Indicates the date and time that a document was created. This information is stored in the document, not obtained from the file system.

Document_DatePrinted

Indicates the date and time the document was last printed. The legacy name is "DocLastPrinted".

Document_DateSaved

Indicates the date and time the document was last saved. The legacy name is "DocLastSavedTm".

Document_Division


Document_DocumentID


Document_HiddenSlideCount


Document_LastAuthor


Document_LineCount


Document_Manager


Document_MultimediaClipCount


Document_NoteCount


Document_PageCount


Document_ParagraphCount


Document_PresentationFormat


Document_RevisionNumber


Document_Security

Access control information, from SummaryInfo propset

Document_SlideCount


Document_Template


Document_TotalEditingTime

This property represents the total time between each open and save, accumulated since the creation of the document. This is measured in 100ns units, not milliseconds. VT_FILETIME for IPropertySetStorage handlers (legacy)

Document_Version


Document_WordCount


Image

Image_BitDepth

Indicates how many bits are used in each pixel of the image. (Usually 8, 16, 24, or 32).

Image_ColorSpace

The colorspace embedded in the image. Taken from the Exchangeable Image File (EXIF) information.

Image_CompressedBitsPerPixel

Indicates the image compression level. . Calculated from PKEY_Image_CompressedBitsPerPixelNumerator and PKEY_Image_CompressedBitsPerPixelDenominator.

Image_CompressedBitsPerPixelDenominator

The denominator of PKEY_Image_CompressedBitsPerPixel.

Image_CompressedBitsPerPixelNumerator

The numerator of PKEY_Image_CompressedBitsPerPixel.

Image_Compression

The algorithm used to compress the image.

Image_CompressionText

The user-friendly form of System.Image.Compression. Not intended to be parsed programmatically.

Image_Dimensions

The image dimensions in string format as

Image_HorizontalResolution

Indicates the number of pixels per resolution unit in the image width.

Image_HorizontalSize

The horizontal size of the image, in pixels.

Image_ImageID


Image_ResolutionUnit

Indicates the resolution units. Used for images with a non-square aspect ratio, but without meaningful absolute dimensions. 1 = No absolute unit of measurement. 2 = Inches. 3 = Centimeters. The default value is 2 (Inches).

Image_VerticalResolution

Indicates the number of pixels per resolution unit in the image height.

Image_VerticalSize

The vertical size of the image, in pixels.

Media

Media_AuthorUrl


Media_AverageLevel


Media_ClassPrimaryID


Media_ClassSecondaryID


Media_CollectionGroupID


Media_CollectionID


Media_ContentDistributor


Media_ContentID


Media_CreatorApplication


Media_CreatorApplicationVersion


Media_DateEncoded

Represents the date and time the file was encoded. The DateTime is in UTC (in the doc, not file system).

Media_DateReleased


Media_Duration

Represents the actual play time of a media file and is measured in 100ns units, not milliseconds.

Media_DVDID


Media_EncodedBy


Media_EncodingSettings


Media_FrameCount

Indicates the frame count for the image.

Media_MCDI


Media_MetadataContentProvider


Media_Producer


Media_PromotionUrl


Media_ProtectionType

Describes the type of media protection.

Media_ProviderRating

The rating (0 - 99) supplied by metadata provider.

Media_ProviderStyle

Represents the actual play time of a media file and is measured in 100ns units, not milliseconds.

Media_Publisher


Media_SubscriptionContentId


Media_SubTitle


Media_UniqueFileIdentifier


Media_UserNoAutoInfo

If true, do not alter this file's metadata. Set by user.

Media_UserWebUrl


Media_Writer


Media_Year


Music

Music_AlbumArtist


Music_AlbumTitle


Music_Artist


Music_BeatsPerMinute


Music_Composer


Music_Conductor


Music_ContentGroupDescription


Music_Genre


Music_InitialKey


Music_Lyrics


Music_Mood


Music_PartOfSet


Music_Period


Music_SynchronizedLyrics


Music_TrackNumber


Photo

Photo_Aperture

The aperture value of the image, in APEX units. See the Exchangeable Image File (EXIF) 2.2 specification, Annex C, for a comparison of

Photo_ApertureDenominator

The denominator of

Photo_ApertureNumerator

The date when the photo was taken, as read from the camera in the file's Exchangeable Image File (EXIF) tag.

Photo_Brightness

The brightness value of the image, in APEX units, usually in the range of -99.99 to 99.99.

Photo_BrightnessDenominator

The brightness value of the image, in APEX units, usually in the range of -99.99 to 99.99.

Photo_BrightnessNumerator

The numerator of PKEY_Photo_Brightness.

Photo_CameraManufacturer

The manufacturer name of the camera that took the photo, in a string format.

Photo_CameraModel

The model name of the camera that shot the photo, in string form.

Photo_CameraSerialNumber

The serial number of the camera that produced the photo.

Photo_Contrast

Indicates the direction of contrast processing applied by the camera when the image was taken. "0" indicates "Normal"; "1" indicates "Soft"; "2" indicates "Hard".

Photo_ContrastText

The user-friendly form of System.Photo.Contrast. It is not intended to be parsed programmatically.

Photo_DateTaken

The date when the photo was taken, as read from the camera in the file's Exchangeable Image File (EXIF) tag.

Photo_DigitalZoom

The digital zoom ratio when the image was shot. Read from the camera in the file's Exchangeable Image File (EXIF) information. This property is calculated from

Photo_DigitalZoomDenominator

The denominator of PKEY_Photo_DigitalZoom.

Photo_DigitalZoomNumerator

The numerator of PKEY_Photo_DigitalZoom.

Photo_Event

The event where the photo was taken. The end-user provides this value.

Photo_EXIFVersion

The Exchangeable Image File (EXIF) version.

Photo_ExposureBias

The amount of exposure bias used in the photo, as read from the camera. This property is calculated from

Photo_ExposureBiasDenominator

The denominator of PKEY_Photo_ExposureBias.

Photo_ExposureBiasNumerator

The numerator of PKEY_Photo_ExposureBias.

Photo_ExposureIndex

Indicates the exposure index selected on the camera or input device at the time the photo was taken. Calculated from PKEY_Photo_ExposureIndexNumerator and PKEY_Photo_ExposureIndexDenominator.

Photo_ExposureIndexDenominator

the denominator of PKEY_Photo_ExposureIndex.

Photo_ExposureIndexNumerator

The numerator of PKEY_Photo_ExposureIndex.

Photo_ExposureProgram

The Exposure Program mode of the camera at the time the photo was taken, as read from the Exchangeable Image File (EXIF) information.

Photo_ExposureProgramText

The user-friendly form of System.Photo.ExposureProgram. Not intended to be parsed programmatically.

Photo_ExposureTime

The exposure time for the photo, in seconds, as read from the Exchangeable Image File (EXIF) information. This property is calculated from

Photo_ExposureTimeDenominator

The denominator of PKEY_Photo_ExposureTime.

Photo_ExposureTimeNumerator

The numerator of PKEY_Photo_ExposureTime.

Photo_Flash

An indicator of the flash status when the photo was taken, as read from the Exchangeable Image File (EXIF) info.

Photo_FlashEnergy

Indicates the strobe energy at the time the image was captured, measured in Beam Candle Power Seconds. Calculated from PKEY_Photo_FlashEnergyNumerator and PKEY_Photo_FlashEnergyDenominator.

Photo_FlashEnergyDenominator

The denominator of PKEY_Photo_FlashEnergy.

Photo_FlashEnergyNumerator

The numerator of PKEY_Photo_FlashEnergy.

Photo_FlashManufacturer

A string indicating the manufacturer of the flash used to take the picture. Can be blank or not present.

Photo_FlashModel

The amount of exposure bias used in the photo, as read from the camera. This property is calculated from

Photo_FlashText

The user-friendly form of

Photo_FNumber

The FNumber value when the photo was taken, as read from the Exchangeable Image File (EXIF) information.This property is calculated from

Photo_FNumberDenominator

The denominator of PKEY_Photo_FNumber.

Photo_FNumberNumerator

The numerator of PKEY_Photo_FNumber.

Photo_FocalLength

The focal length of the lens as recorded by the camera when the photo was taken, measured in millimeters. This is the actual focal length without conversion to 35mm (

Photo_FocalLengthDenominator

The denominator of PKEY_Photo_FocalLength.

Photo_FocalLengthInFilm

The focal length of the lens when the photo was taken, as converted to a 35mm film measurement.

Photo_FocalLengthNumerator

The numerator of PKEY_Photo_FocalLength.

Photo_FocalPlaneXResolution

Indicates the number of pixels in the image width (X direction) per FocalPlaneResolutionUnit on the camera focal plane. Calculated from PKEY_Photo_FocalPlaneXResolutionNumerator and PKEY_Photo_FocalPlaneXResolutionDenominator.

Photo_FocalPlaneXResolutionDenominator

The denominator of PKEY_Photo_FocalPlaneXResolution.

Photo_FocalPlaneXResolutionNumerator

The numerator of PKEY_Photo_FocalPlaneXResolution.

Photo_FocalPlaneYResolution

Indicates the number of pixels in the image height (Y direction) per FocalPlaneResolutionUnit on the camera focal plane. Calculated from PKEY_Photo_FocalPlaneYResolutionNumerator and PKEY_Photo_FocalPlaneYResolutionDenominator.

Photo_FocalPlaneYResolutionDenominator

The denominator of PKEY_Photo_FocalPlaneYResolution.

Photo_FocalPlaneYResolutionNumerator

The numerator of PKEY_Photo_FocalPlaneYResolution.

Photo_GainControl

Indicates the degree of overall image gain adjustment. Calculated from PKEY_Photo_GainControlNumerator and PKEY_Photo_GainControlDenominator.

Photo_GainControlDenominator

The denominator of PKEY_Photo_GainControl.

Photo_GainControlNumerator

The numerator of PKEY_Photo_GainControl.

Photo_GainControlText

The user-friendly form of

Photo_ISOSpeed

The International Standards Organization (ISO) speed as recorded by the camera when the photo was taken.

Photo_LensManufacturer

String indicating the manufacturer of the lens used to take the picture. Can be blank or not present.

Photo_LensModel

A string indicating the model of the lens used to take the picture. Can be blank or not present.

Photo_LightSource

The light source when the photo was taken, as read from the Exchangeable Image File (EXIF) information.

Photo_MakerNote

The Exchangeable Image File (EXIF) extensibility mechanism that allows camera manufacturers to provide custom information. This property is not intended to be displayed in the Shell, but it is available programmatically to applications.

Photo_MakerNoteOffset

The offset for the maker note specified in

Photo_MaxAperture

The maximum aperture of the lens as recorded by the camera, taken from the Exchangeable Image File (EXIF) information. This property is calculated from

Photo_MaxApertureDenominator

The denominator of PKEY_Photo_MaxAperture.

Photo_MaxApertureNumerator

The numerator of PKEY_Photo_MaxAperture.

Photo_MeteringMode

The metering mode used by the camera, taken from the Exchangeable Image File (EXIF) information.

Photo_MeteringModeText

The user-friendly form of

Photo_Orientation

The orientation of the photo when it was taken, as specified in the Exchangeable Image File (EXIF) information and in terms of rows and columns. This allows applications and the Shell to properly orient the image, instead of orienting the pixels and persisting the image in the requested display orientation, which can result in a loss of fidelity. This property is not meant to be displayed in the user interface (UI).

Photo_OrientationText

The user-friendly form of

Photo_PhotometricInterpretation

The pixel composition. In JPEG compressed data, a JPEG marker is used instead of this property.

Photo_PhotometricInterpretationText

The user-friendly form of

Photo_ProgramMode

The class of the program used by the camera to set exposure.

Photo_ProgramModeText

The user-friendly form of

Photo_RelatedSoundFile

The file name of a sound annotation file associated with the photo.

Photo_Saturation

Indicates the direction of saturation processing applied by the camera when the photo was taken.

Photo_SaturationText

The user-friendly form of

Photo_Sharpness

Indicates the direction of sharpness processing applied by the camera when the photo was taken.

Photo_SharpnessText

The user-friendly form of

Photo_ShutterSpeed

The shutter speed of the camera when the photo was taken. This is given in APEX units. This property is calculated from

Photo_ShutterSpeedDenominator

The denominator of PKEY_Photo_ShutterSpeed.

Photo_ShutterSpeedNumerator

The numerator of PKEY_Photo_ShutterSpeed.

Photo_SubjectDistance

The distance to the subject in meters. Calculated from PKEY_Photo_SubjectDistanceNumerator and PKEY_Photo_SubjectDistanceDenominator.

Photo_SubjectDistanceDenominator

The denominator of PKEY_Photo_SubjectDistance.

Photo_SubjectDistanceNumerator

The numerator of PKEY_Photo_SubjectDistance.

Photo_TranscodedForSync

A VT_BOOL that indicates whether the image has been transcoded for synchronizing with an external device.

Photo_WhiteBalance

The white balance mode at the time the photo was shot, as taken from the Exchangeable Image File (EXIF) information.

Photo_WhiteBalanceText

The white balance mode at the time the photo was shot, as taken from the Exchangeable Image File (EXIF) information.

Search

Search_AutoSummary

An automated search system summary of the full text contents of a document, displayed in the search results view in

Search_Rank

Relevance rank of row, with a range from 0-1000. Larger numbers mean better matches. Query-time only; not defined in Search schema. This property is retrievable but not searchable.

Video

Video_Compression

Indicates the level of compression for the video stream. "Compression".

Video_Director

Indicates the person who directed the video.

Video_EncodingBitrate

Indicates the data rate in "bits per second" for the video stream. "DataRate".

Video_FourCC

Indicates the 4CC for the video stream.

Video_FrameHeight

Indicates the frame height for the video stream.

Video_FrameRate

Indicates the frame rate in "frames per millisecond" for the video stream. "FrameRate".

Video_FrameWidth

Indicates the frame width for the video stream.

Video_HorizontalAspectRatio

Indicates the horizontal portion of the aspect ratio. The X portion of XX:YY. For example, 16 is the X portion of 16:9.

Video_SampleSize

Indicates the sample size in bits for the video stream. "SampleSize".

Video_StreamName

Indicates the name for the video stream. "StreamName".

Video_StreamNumber

Indicates the ordinal number of the stream being played.

Video_TotalBitrate

Indicates the total data rate in "bits per second" for all video and audio streams.

Video_VerticalAspectRatio

Indicates the vertical portion of the aspect ratio. The Y portion of XX:YY. For example, nine is the Y portion of 16:9.

Indexing Service Column Types

Column Type

Description

DocAppName

Name of application that created the file.

DocAuthor

Author of document.

DocByteCount

Number of bytes in a document.

DocCategory

Type of document such as a memo, schedule, or white paper

DocCharCount

Number of characters in document.

DocComments

Comments about document.

DocCompany

Name of the company for which the document was written.

DocHiddenCount

Number of hidden slides in a Microsoft® PowerPoint document.

DocKeywords

Document keywords.

DocLastAuthor

Most recent user who edited document.

DocLastPrinted

Time document was last printed.

DocLineCount

Number of lines contained in a document.

DocManager

Name of the manager of the document’s author.

DocNoteCount

Number of pages with notes in a PowerPoint document.

DocPageCount

Number of pages in document.

DocParaCount

Number of paragraphs in a document.

DocPartTitles

Names of document parts. For example, in Microsoft Excel part titles are the names of spreadsheets; in PowerPoint, slide titles; and in Word for Windows, the names of the documents in the master document.

DocPresentationTarget

Target format (35mm, printer, video, and so on) for a presentation in PowerPoint.

DocRevNumber

Current version number of document.

DocSlideCount

Number of slides in a PowerPoint document.

DocSubject

Subject of document.

DocTemplate

Name of template for document.

DocTitle

Title of document.

DocWordCount

Number of words in document.

HitCount

Number of hits (words matching query) in file.

Rank

Rank of row. Ranges from 0 to 1000. Larger numbers indicate better matches.