SetFileAttributesFromAppW 函式 (fileapifromapp.h)
設定檔案或目錄的屬性。 此函式的行為與SetFileAttributes相同，不同之處在于此函式遵守通用 Windows 平臺應用程式安全性模型。
語法
WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
LPCWSTR lpFileName,
DWORD dwFileAttributes
) noexcept;
參數
lpFileName
要設定其屬性的檔案名。
如需退出宣告 MAX_PATH 限制而不加上 「\\？\」 的詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節以取得詳細資料。
dwFileAttributes
要為檔案設定的檔案屬性。
此參數可以是一或多個值，使用位 OR 運算子結合。 不過，所有其他值都會覆寫 FILE_ATTRIBUTE_NORMAL。
此函式不支援所有屬性。
以下是支援的屬性值清單。
| 值 | 意義 |
|---|---|
| FILE_ATTRIBUTE_ARCHIVE 32 (0x20) | 封存檔案或目錄的檔案或目錄。 應用程式通常會使用這個屬性來標記要備份或移除的檔案。 |
| FILE_ATTRIBUTE_HIDDEN 2 (0x2) | 檔案或目錄已隱藏。 它不包含在一般目錄清單中。 |
| FILE_ATTRIBUTE_NORMAL 128 (0x80) | 未設定其他屬性的檔案。 這個屬性只有在單獨使用時才有效。 |
| FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000) | 檔案或目錄不是由內容索引服務編制索引。 |
| FILE_ATTRIBUTE_OFFLINE 4096 (0x1000) | 檔案的資料無法立即使用。 這個屬性工作表示檔案資料實際上會移至離線儲存體。 遠端儲存體會使用這個屬性，這是階層式儲存體管理軟體。 應用程式不應該任意變更這個屬性。 |
| FILE_ATTRIBUTE_READONLY 1 (0x1) | 唯讀的檔案。 應用程式可以讀取檔案，但無法寫入或刪除檔案。 目錄上不接受這個屬性。 |
| FILE_ATTRIBUTE_SYSTEM 4 (0x4) | 作業系統使用的檔案或目錄，或獨佔使用。 |
| FILE_ATTRIBUTE_TEMPORARY 256 (0x100) | 用於暫存儲存體的檔案。 檔案系統可避免在有足夠的快取記憶體可用時將資料寫回大量儲存體，因為應用程式通常會在關閉控制碼之後刪除暫存檔。 在該案例中，系統可以完全避免寫入資料。 否則，會在關閉控制碼之後寫入資料。 |
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
需求
| 最低支援的用戶端 | Windows 10 (版本 1803) |
| 標頭 | fileapifromapp.h |