GetFileAttributesEx  566A38 

[New - Windows NT]

The GetFileAttributesEx function obtains attribute information about a specified file or directory.

This function is similar to the GetFileAttributes3PQDMO function. GetFileAttributes returns a set of FAT-style attribute information. GetFileAttributesEx is designed to obtain other sets of file or directory attribute information. Currently, GetFileAttributeEx obtains a set of standard attributes that is a superset of the FAT-style attribute information.

BOOL GetFileAttributesEx(

Parameters

lpFileName

Pointer to a null-terminated string that specifies a file or directory.

By default, this string is limited to MAX_PATH characters. The limit is related to how the GetFileAttributesEx function parses paths. An application can transcend this limit and send in paths longer than MAX_PATH characters by calling the wide (W) version of GetFileAttributesEx and prepending  \\?\  to the path. The  \\?\  tells the function to turn off path parsing. This technique also works with UNC names. The  \\?\  is ignored as part of the path. For example,  \\?\C:\myworld\private  is seen as  C:\myworld\private , and  \\?\UNC\peanuts\hotstuff\coolapps  is seen as  \\peanuts\hotstuff\coolapps .

fInfoLevelId

Enumeration type value that specifies the set of attribute information to obtain.

You can use the following value for fInfoLevelId:

Future releases of Win32-based operating systems and extensions may define other values for the GET_FILEEX_INFO_LEVELS enum type.

lpFileInformation

Pointer to a buffer that receives the attribute information.

The type of attribute information stored into this buffer is determined by the value of fInfoLevelId, as follows:

Return Values

If the function succeeds, the return value is a nonzero value.

If the function fails, the return value is zero. To get extended error information, call GetLastError11C2VS7.

See Also