FileSetAttr - C++ Builder

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

---

设置文件属性

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

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

参数：

• FileName：文件名；
• Attr：文件属性，每个属性以按位或的方式组合在一起，详见本文后面表格；
• FollowLink：是否跟踪符号链接 (symbolic link)；

返回值：

• 这个函数只支持 Windows 操作系统；
• 设置文件属性成功，函数返回 0，设置文件属性失败，返回错误码 (等于 GetLastError 的值)；
• 如果 FileName 是相对路径，即不是完整的路径 (不是从盘符或根目录开始的)，会在当前路径下查找文件，当前路径可能是用户文件夹，可执行文件文件夹本身，或者创建快捷方式时指定的文件夹：
  • 可以通过 SetCurrentDir 修改当前文件夹位置；
  • 可以通过 GetCurrentDir 获取当前文件夹位置；
  • 为了准确的指定文件的位置，最好使用完整的路径，即从盘符 (Windows) 或根目录开始 (其他系统) 的文件位置；
• FollowLink：检查链接的目标是否存在，规则与 FileExists 相同。

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

---

相关：

• System::Sysutils::FileGetAttr
• System::Sysutils::FileSetAttr
• System::Sysutils::FileIsReadOnly
• System::Sysutils::FileSetReadOnly
• System::Sysutils::FileAge
• System::Sysutils::FileGetDate
• System::Sysutils::FileGetDateTimeInfo
• System::Sysutils::FileSetDate
• 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::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 ➙ FileSetAttr