FileGetAttr - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ FileGetAttr

---

获取文件属性

头文件：#include
命名空间：System::Sysutils
函数原型：

int __fastcall FileGetAttr(const System::UnicodeString FileName, bool FollowLink = true);

参数：

• FileName：文件名；
• FollowLink：是否跟踪符号链接 (symbolic link)；

返回值：

• 文件属性：每个属性以按位或的方式组合在一起，详见本文后面表格；
• faInvalid：文件不存在，或者链接目标不存在；
• 如果 FileName 是相对路径，即不是完整的路径 (不是从盘符或根目录开始的)，会在当前路径下查找文件，当前路径可能是用户文件夹，可执行文件文件夹本身，或者创建快捷方式时指定的文件夹：
  • 可以通过 SetCurrentDir 修改当前文件夹位置；
  • 可以通过 GetCurrentDir 获取当前文件夹位置；
  • 为了准确的指定文件的位置，最好使用完整的路径，即从盘符 (Windows) 或根目录开始 (其他系统) 的文件位置；
• FollowLink：检查链接的目标是否存在，规则与 FileExists 相同。

属性	描述
faInvalid	无效的文件 (在数值上相当于所有属性全部置位， 所以需要先判断是否等于这个值)
faReadOnly	只读
faHidden	隐藏
faSysFile	系统
faVolumeID	卷标 (过时的属性)
faDirectory	文件夹
faArchive	归档，如果文件被修改这个属性会被置位。 新创建的文件一般都有这个属性， 把这个属性清掉之后，如果发现这个属性被置位了， 可以认为这个文件被修改了
faNormal	文件没有其他属性，这个属性独立存在
faTemporary	临时文件
faSymLink	符号链接
faCompressed	压缩
faEncrypted	加密
faVirtual	虚拟文件
faAnyFile	文件不会有这个属性值，这是在查找文件时使用的值

---

相关：

• System::Sysutils::CreateDir
• System::Sysutils::ForceDirectories
• System::Sysutils::RemoveDir
• System::Sysutils::GetCurrentDir
• System::Sysutils::SetCurrentDir
• System::Sysutils::FileExists
• System::Sysutils::DirectoryExists
• System::Sysutils::FileSearch
• System::Sysutils::FindFirst
• System::Sysutils::FindNext
• System::Sysutils::FindClose
• System::Sysutils::FileAge
• System::Sysutils::FileGetDate
• System::Sysutils::FileGetDateTimeInfo
• System::Sysutils::FileSetDate
• System::Sysutils::FileGetAttr
• System::Sysutils::FileSetAttr
• System::Sysutils::FileIsReadOnly
• System::Sysutils::FileSetReadOnly
• System::Sysutils::DeleteFile
• System::Sysutils::RenameFile
• System::Sysutils::IsAssembly
• System::Sysutils::DiskFree
• System::Sysutils::DiskSize
• System::Sysutils::FileDateToDateTime
• System::Sysutils::DateTimeToFileDate
• System::Sysutils

---

C++ Builder 参考手册 ➙ System::Sysutils ➙ FileGetAttr