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

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions
GetFileAttributes
GET_FILEEX_INFO_LEVELS
SetFileAttributes
WIN32_FILE_ATTRIBUTE_DATA