Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

This function is similar to the GetFileAttributesfunction. GetFileAttributesreturns 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_LEVELSenumeration type that specifies the set of attribute information to obtain.

lpFileInformation

[out] Pointer to a WIN32_FILE_ATTRIBUTE_DATAstructure 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