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. |
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 |