GetFileAttributesEx

【勇芳软件工作室】汉化HomePreviousNext

[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】
GetFileExInfoStandardWIN32_FILE_ATTRIBUTE_DATA.

返回值

如果函数成功,则返回值为非零值。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

也可以看看

GetFileAttributes, SetFileAttributes, WIN32_FILE_ATTRIBUTE_DATA