SetFileAttributes

聲明

Declare Function SetFileAttributes Lib "kernel32" Alias "SetFileAttributesA" (ByVal lpFileName As String, ByVal dwFileAttributes As Long) As Long

說明

設定檔案屬性

返回值

Long，非零表示成功，零表示失敗。會設定GetLastError

參數表

參數類型及說明

lpFileName String，要設定其屬性的檔案名稱

dwFileAttributes Long，帶有FILE_ATTRIBUTE_??前綴的一個或多個常數

VC

函式原型

BOOL SetFileAttributes(

LPCTSTR lpFileName,

DWORD dwFileAttributes

);

lpFileName的對象[in]指向一個字元串，指定其屬性要設定的檔案的名稱。在這個函式的ANSI版本，該名稱限制在MAX_PATH字元。為了拓展此限制到32,767寬字元，調用Unicode版本的功能和前面加上“\\？\”的路徑。欲了解更多信息，請參閱命名檔案。

Windows Me / 98/95:這個字元串不得超過MAX_PATH字元。dwFileAttributes[在]檔案屬性設定的檔案。該參數可以是下列一個或多個值。然而,其他值覆蓋FILE_ATTRIBUTE_NORMAL。

Attribute	Meaning
FILE_ATTRIBUTE_ARCHIVE	該檔案是一個存檔檔案。應用程式使用此屬性來備份或移除標記檔案。
FILE_ATTRIBUTE_HIDDEN	該檔案是隱藏的。它不包括在普通的目錄列表。
FILE_ATTRIBUTE_NORMAL	該檔案沒有設定其他的屬性。此屬性僅在單獨使用有效。
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	該檔案將不被內容索引服務編制索引。
FILE_ATTRIBUTE_OFFLINE	該檔案的數據不是立即可用。此屬性表明檔案數據被物理移動到離線存儲。此屬性用於通過遠程存儲，分層存儲管理軟體。應用程式不應隨意更改此屬性。
FILE_ATTRIBUTE_READONLY	該檔案是唯讀的。應用程式可以讀取該檔案，但不能寫入或刪除它。
FILE_ATTRIBUTE_SYSTEM	該檔案是作業系統的一部分，或者完全由它使用。
FILE_ATTRIBUTE_TEMPORARY	該檔案是被用於暫時存儲。檔案系統避免寫入數據傳回海量存儲如果有足夠的快取記憶體可用，因為經常在應用程式刪除後不久，這個句柄被關閉的臨時檔案。在這種情況下，該系統可以完全避免記錄的數據。否則，在手柄關閉的數據將被寫入。