FileSetAttr - C++ Builder

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