C++ Builder 参考手册 ➙ System::Sysutils ➙ FileSetAttr
设置文件属性
头文件：#include <System.SysUtils.hpp>
命名空间：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
