Partilhar via


2.6 File Attributes

The following attributes are defined for files and directories. They can be used in any combination unless noted in the description of the attribute's meaning. There is no file attribute with the value 0x00000000 because a value of 0x00000000 in the FileAttributes field means that the file attributes for this file MUST NOT be changed when setting basic information for the file.

Note: File systems silently ignore any attribute that is not supported by that file system.  Unsupported attributes MUST NOT be persisted on the media. It is recommended that unsupported attributes be masked off when encountered.

Value

Meaning

FILE_ATTRIBUTE_READONLY

0x00000001

A file or directory that is read-only. For a file, applications can read the file but cannot write to it or delete it. For a directory, applications cannot delete it, but applications can create and delete files from that directory.

FILE_ATTRIBUTE_HIDDEN

0x00000002

A file or directory that is hidden. Files and directories marked with this attribute do not appear in an ordinary directory listing.

FILE_ATTRIBUTE_SYSTEM

0x00000004

A file or directory that the operating system uses a part of or uses exclusively.

FILE_ATTRIBUTE_DIRECTORY

0x00000010

This item is a directory.

FILE_ATTRIBUTE_ARCHIVE

0x00000020

A file or directory that requires to be archived. Applications use this attribute to mark files for backup or removal.

FILE_ATTRIBUTE_NORMAL

0x00000080

A file that does not have other attributes set. This flag is used to clear all other flags by specifying it with no other flags set.

This flag MUST be ignored if other flags are set.<174>

FILE_ATTRIBUTE_TEMPORARY

0x00000100

A file that is being used for temporary storage. The operating system can choose to store this file's data in memory rather than on mass storage, writing the data to mass storage only if data remains in the file when the file is closed.

FILE_ATTRIBUTE_SPARSE_FILE

0x00000200

A file that is a sparse file.

FILE_ATTRIBUTE_REPARSE_POINT

0x00000400

A file or directory that has an associated reparse point.

FILE_ATTRIBUTE_COMPRESSED

0x00000800

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.

FILE_ATTRIBUTE_OFFLINE

0x00001000

The data in this 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 hierarchical storage management software.

FILE_ATTRIBUTE_NOT_CONTENT_INDEXED

0x00002000

A file or directory that is not indexed by the content indexing service.

FILE_ATTRIBUTE_ENCRYPTED

0x00004000

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.

FILE_ATTRIBUTE_INTEGRITY_STREAM

0x00008000

A file or directory that is configured with integrity support. For a file, all data streams in the file have integrity support. For a directory, integrity support is the default for newly created files and subdirectories, unless the caller specifies otherwise.<175>

FILE_ATTRIBUTE_NO_SCRUB_DATA

0x00020000

A file or directory that is configured to be excluded from the data integrity scan. For a directory configured with FILE_ATTRIBUTE_NO_SCRUB_DATA, the default for newly created files and subdirectories is to inherit the FILE_ATTRIBUTE_NO_SCRUB_DATA attribute.<176>

FILE_ATTRIBUTE_RECALL_ON_OPEN

0x00040000

This attribute appears only in directory enumeration classes (FILE_DIRECTORY_INFORMATION, FILE_BOTH_DIR_INFORMATION, etc.). When this attribute is set, it means that the file or directory has no physical representation on the local system; the item is virtual. Opening the item will be more expensive than usual because it will cause at least some of the file or directory content to be fetched from a remote store. This attribute can only be set by kernel-mode components. This attribute is for use with hierarchical storage management software.<177>

FILE_ATTRIBUTE_PINNED

0x00080000

This attribute indicates user intent that the file or directory should be kept fully present locally even when not being actively accessed. This attribute is for use with hierarchical storage management software.<178>

FILE_ATTRIBUTE_UNPINNED

0x00100000

This attribute indicates that the file or directory should not be kept fully present locally except when being actively accessed. This attribute is for use with hierarchical storage management software.<179>

FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS

0x00400000

When this attribute is set, it means that the file or directory is not fully present locally. For a file this means that not all of its data is on local storage (for example, it may be sparse with some data still in remote storage). For a directory it means that some of the directory contents are being virtualized from another location. Reading the file or enumerating the directory will be more expensive than usual because it will cause at least some of the file or directory content to be fetched from a remote store. Only kernel-mode callers can set this attribute. This attribute is for use with hierarchical storage management software.<180>