File Attribute Constants
Applies to: desktop apps only
File attributes are metadata values stored by the file system on disk and are used by the system and are available to developers via various file I/O APIs. For a list of related APIs and topics, see the See Also section.
| Constant/value | Description |
|---|---|
|
A file or directory that is an archive file or directory. Applications typically use this attribute to mark files for backup or removal . |
|
A file or directory that is compressed. For a file, all of the data in the file is compressed. For a directory, compression is the default for newly created files and subdirectories. |
|
This value is reserved for system use. |
|
The handle that identifies a directory. |
|
A file or directory that is encrypted. For a file, all data streams in the file are encrypted. For a directory, encryption is the default for newly created files and subdirectories. |
|
The file or directory is hidden. It is not included in an ordinary directory listing. |
|
The directory or user data stream is configured with integrity (only supported on ReFS volumes). It is not included in an ordinary directory listing. The integrity setting persists with the file if it's renamed. If a file is copied the destination file will have integrity set if either the source file or destination directory have integrity set.
|
|
A file that does not have other attributes set. This attribute is valid only when used alone. |
|
The file or directory is not to be indexed by the content indexing service. |
|
The user data stream not to be read by the background data integrity scanner (AKA scrubber). When set on a directory it only provides inheritance. This flag is only supported on Storage Spaces and ReFS volumes. It is not included in an ordinary directory listing.
|
|
The data of a file is not available immediately. This attribute indicates that the file data is physically moved to offline storage. This attribute is used by Remote Storage, which is the hierarchical storage management software. Applications should not arbitrarily change this attribute. |
|
A file that is read-only. Applications can read the file, but cannot write to it or delete it. This attribute is not honored on directories. For more information, see You cannot view or change the Read-only or the System attributes of folders in Windows Server 2003, in Windows XP, in Windows Vista or in Windows 7. |
|
A file or directory that has an associated reparse point, or a file that is a symbolic link. |
|
A file that is a sparse file. |
|
A file or directory that the operating system uses a part of, or uses exclusively. |
|
A file that is being used for temporary storage. File systems avoid writing data back to mass storage if sufficient cache memory is available, because typically, an application deletes a temporary file after the handle is closed. In that scenario, the system can entirely avoid writing the data. Otherwise, the data is written after the handle is closed. |
|
This value is reserved for system use. |
Requirements
|
Minimum supported client | Windows XP |
|---|---|
|
Minimum supported server | Windows Server 2003 |
|
Header |
|
See also
- Compression Attribute
- Creating and Opening Files
- CreateFile
- CreateFileTransacted
- GetFileAttributes
- GetFileAttributesEx
- GetFileAttributesTransacted
- GetFileInformationByHandle
- GetFileInformationByHandleEx
- SetFileAttributes
- SetFileAttributesTransacted
- SetFileInformationByHandle
Send comments about this topic to Microsoft
Build date: 4/17/2012