GetFileAttributesEx

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function obtains attribute information about a specified file or directory.

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

Syntax

BOOL GetFileAttributesEx(
  LPCTSTR lpFileName, 
  GET_FILEEX_INFO_LEVELS fInfoLevelId, 
  LPVOID lpFileInformation 
);

Parameters

• lpFileName
  [in] 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 this function parses paths. Windows Embedded CE does not support the \\?\ override of the MAX_PATH limit and does not support wildcard characters.

• fInfoLevelId
  [in] GET_FILEEX_INFO_LEVELS enumeration type that specifies the set of attribute information to obtain.

• lpFileInformation
  [out] Pointer to a WIN32_FILE_ATTRIBUTE_DATA structure that receives the attribute information.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Requirements

See Also

Reference

File I/O Functions
GetFileAttributes
GET_FILEEX_INFO_LEVELS
SetFileAttributes
WIN32_FILE_ATTRIBUTE_DATA