Share via


2.2.1.2.3 SMB_EXT_FILE_ATTR

A 32-bit field containing encoded file attribute values and file access behavior flag values. The attribute and flag value names are for reference purposes only. If ATTR_NORMAL (see following) is set as the requested attribute value, it MUST be the only attribute value set. Including any other attribute value causes the ATTR_NORMAL value to be ignored. Any combination of the flag values (see following) is acceptable.<14>

This type is declared as follows:

 typedef DWORD SMB_EXT_FILE_ATTR;

Name and bitmask

Meaning

ATTR_READONLY

0x00000001

The file is read only. Applications can read the file but cannot write to it or delete it.

ATTR_HIDDEN

0x00000002

The file is hidden. It is not to be included in an ordinary directory listing.

ATTR_SYSTEM

0x00000004

The file is part of or is used exclusively by the operating system.

ATTR_DIRECTORY

0x00000010

The file is a directory.

ATTR_ARCHIVE

0x00000020

The file has not been archived since it was last modified.

ATTR_NORMAL

0x00000080

The file has no other attributes set. This attribute is valid only if used alone.

ATTR_TEMPORARY

0x00000100

The file is temporary. This is a hint to the cache manager that it does not need to flush the file to backing storage.

ATTR_COMPRESSED

0x00000800

The file or directory is compressed. For a file, this means that all of the data in the file is compressed. For a directory, this means that compression is the default for newly created files and subdirectories.

POSIX_SEMANTICS

0x01000000

Indicates that the file is to be accessed according to POSIX rules. This includes allowing multiple files with names differing only in case, for file systems that support such naming.<15>

BACKUP_SEMANTICS

0x02000000

Indicates that the file is being opened or created for a backup or restore operation. The server SHOULD allow the client to override normal file security checks, provided it has the necessary permission to do so.

DELETE_ON_CLOSE

0x04000000

Requests that the server delete the file immediately after all of its handles have been closed.

SEQUENTIAL_SCAN

0x08000000

Indicates that the file is to be accessed sequentially from beginning to end.<16>

RANDOM_ACCESS

0x10000000

Indicates that the application is designed to access the file randomly. The server can use this flag to optimize file caching.

NO_BUFFERING

0x20000000

Requests that the server open the file with no intermediate buffering or caching; the server might not honor the request. The application MUST meet certain requirements when working with files opened with FILE_FLAG_NO_BUFFERING. File access MUST begin at offsets within the file that are integer multiples of the volume's sector size and MUST be for numbers of bytes that are integer multiples of the volume's sector size. For example, if the sector size is 512 bytes, an application can request reads and writes of 512, 1024, or 2048 bytes, but not of 335, 981, or 7171 bytes.

WRITE_THROUGH

0x80000000

Instructs the operating system to write through any intermediate cache and go directly to the file. The operating system can still cache write operations, but cannot lazily flush them.