flAttribute (ULONG) - input

Attribute value that determines the file objects to be searched for.

The bit values are shown in the following list:

31-14

Reserved; must be zero.
13
MUST_HAVE_ARCHIVED (0x00002000)
Must have Archive bit; excludes files without the archive bit set if bit 13 is set to 1. Files may have the Archive bit set if bit 13 is set to 0.
12
MUST_HAVE_DIRECTORY (0x00001000)
Must have Subdirectory bit; excludes files that are not subdirectories if bit 12 is set to 1. Files may have the Subdirectory bit set if bit 12 is set to 0.
11
Reserved; must be zero.
10
MUST_HAVE_SYSTEM (0x00000400)
Must have System File bit; excludes non-system files if bit 10 is set to 1. Files may be system files if bit 10 is set to 0.
9
MUST_HAVE_HIDDEN (0x00000200)
Must have Hidden File bit; excludes non-hidden files if bit 9 is set to 1. Files may be non-hidden if bit 9 is set to 0.
8
MUST_HAVE_READONLY (0x00000100)
Must have Read-Only File bit; excludes writeable files if bit 8 is set to 1. Files may be read-only if bit 8 is set to 0.
7-6
Reserved; must be zero.
5
FILE_ARCHIVED (0x00000020)
May have Archive bit; includes files with the Archive bit set if bit 5 is set to 1. Excludes files with the Archive bit set if bit 5 is set to 0.
4
FILE_DIRECTORY (0x00000010)
May have Subdirectory bit; includes files that are subdirectories if bit 4 is set to 1. Excludes files that are subdirectories if bit 4 is set to 0.
3
Reserved; must be zero.
2
FILE_SYSTEM (0x00000004)
May have System File bit; includes system files if bit 2 is set to 1. Excludes system files if bit 2 is set to 0.
1
FILE_HIDDEN (0x00000002)
May have Hidden File bit; includes hidden files if bit 1 is set to 1. Excludes hidden files if bit 1 is set to 0.
0
FILE_READONLY (0x00000001)
May have Read-Only File bit; includes read-only files if bit 0 is set to 1. Excludes read-only files if bit 0 is set to 0.
These bits may be set individually or in combination. For example, an attribute value of 0x00000021 (bits 5 and 0 set to 1) indicates searching for read-only files that have been archived.

Bits 8 through 13 are "Must-have" flags. These allow you to obtain files that definitely have the given attributes. For example, if the Must have Subdirectory bit is set to 1, then all returned items are subdirectories.

If a Must-have bit is set to 1 and the corresponding May-have bit is set to zero, no items are returned for that attribute.

The attribute FILE_NORMAL (0x00000000) can be used to include files with any of the above bits set.

flAttribute cannot specify the volume label. Volume labels are queried using DosQueryFSInfo.