[New - Windows NT]
GetFileAttributesEx功能获取有关指定文件或目录的属性信息。
此函数类似于GetFileAttributes功能。GetFileAttributes返回一组FAT样式的属性信息。GetFileAttributesEx旨在获取其他文件或目录属性信息集。目前,GetFileAttributeEx获得了一组作为FAT样式属性信息超集的标准属性。
BOOL GetFileAttributesEx(
LPCTSTR 【lpFileName】, | //指向指定文件或目录的字符串的指针 |
GET_FILEEX_INFO_LEVELS 【fInfoLevelId】, | //指定要获取的属性信息的类型的值 |
LPVOID 【lpFileInformation】 | //指向缓冲区的指针,以接收属性信息 |
); |
参数
【lpFileName】
指向指定文件或目录的以空值终止的字符串的指针。
默认情况下,此字符串限制为MAX_PATH个字符。限制与GetFileAttributesEx功能如何解析路径有关。通过调用宽(W)版本GetFileAttributesEx并在路径前面加上“\\\\?”,应用程序可以超越此限制并发送长度超过MAX_PATH字符的路径。“\\\\?\\”告诉功能关闭路径解析。这种技术也适用于UNC名称。“\\\\?\\”作为路径的一部分被忽略。例如,“\\\\?\\ C:\\ myworld \\ private”被视为“C:\\ myworld \\ private”,“\\\\?\\ UNC \\ peanuts \\ hotstuff \\ coolapps”被视为“\\\\ peanuts \\ hotstuff \\ coolapps”。
【fInfoLevelId】
枚举类型值,用于指定要获取的属性信息集。
您可以对【fInfoLevelId】使用以下值:
值 | 含义 |
GetFileExInfoStandard | 该函数获取一组标准属性信息。数据以WIN32_FILE_ATTRIBUTE_DATA结构返回。 |
未来版本的基于Win32的操作系统和扩展可能会为GET_FILEEX_INFO_LEVELS枚举类型定义其他值。
【lpFileInformation】
指向接收属性信息的缓冲区。
存储在此缓冲区中的属性信息的类型由【fInfoLevelId】的值确定,如下所示:
价值【fInfoLevelId】 | 结构存储到* 【lpFileInformation】 |
GetFileExInfoStandard | WIN32_FILE_ATTRIBUTE_DATA. |
返回值
如果函数成功,则返回值为非零值。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
也可以看看
GetFileAttributes, SetFileAttributes, WIN32_FILE_ATTRIBUTE_DATA