基本信息
GetFileAttributes Function為一個指定的檔案或目錄返回檔案系統的屬性。可以使用GetFileAttributesEx 函式獲得更多的屬性信息。如果要實現互動式操作,可以使用GetFileAttributesTransacted 函式。
DWORD WINAPI GetFileAttributes(
__in LPCTSTR lpFileName
);
參數
lpFileName [in]
檔案或目錄的名字,對於ANSI版本,名字不能大於MAX_PATH(260)。
返回值
如果函式成功,返回值包含檔案或目錄的屬性(屬性列表見備註)。如果函式失敗,返回值是INVALID_FILE_ATTRIBUTES。
備註
當該函式作用在一個掛載資料夾時,它返回目錄的檔案系統的屬性,而不是根目錄的信息。為了獲得與檔案屬性關聯的卷信息,可以調用GetVolumeNameForVolumeMountPoint 函式。
函式成功後返回以下值中的一個或多個。
值 | 意義 |
FILE_ATTRIBUTE_ARCHIVE | 標示一個檔案(或目錄)是一個存檔檔案(或目錄)。 |
FILE_ATTRIBUTE_COMPRESSED | 標示一個檔案(或目錄)是一個壓縮檔案(或目錄)。 用於檔案時:該檔案中所有的記錄都是經過壓縮的; 用於目錄時:在該目錄下新建檔案或子目錄時會默認進行壓縮。 |
FILE_ATTRIBUTE_DEVICE | 未使用。 |
FILE_ATTRIBUTE_DIRECTORY | 此句柄被視為一個目錄 |
FILE_ATTRIBUTE_ENCRYPTED | 標示一個檔案(或目錄)是一個加密檔案(或目錄)。 用於檔案時:該檔案中所有的記錄都是經過加密的,包括讀寫操作; 用於目錄時:在該目錄下新建檔案或子目錄時會默認進行加密。 |
FILE_ATTRIBUTE_HIDDEN | 標示一個檔案(或目錄)是一個隱藏檔案(或目錄)。 |
FILE_ATTRIBUTE_NORMAL | 標示一個檔案(或目錄)不具有其他屬性,此屬性只能單獨使用! |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | 標示一個檔案不可被內容索引服務索引。 |
FILE_ATTRIBUTE_OFFLINE | 標示一個檔案是脫機檔案,該檔案中的內容無法直接使用。 如果某個檔案具有該屬性,請不要輕易修改此屬性,它可能是某些遠程存儲服務程式的存儲檔案。 |
FILE_ATTRIBUTE_READONLY | 標示一個檔案(或目錄)是一個唯讀檔案(或目錄)。 用於檔案時:只能讀取檔案內容,無法修改或刪除; 用於目錄時:該目錄無法刪除。 |
FILE_ATTRIBUTE_REPARSE_POINT | 標示一個檔案(或目錄)擁有相關的重新解析點,比如用mklink創建的硬連結(hardLink)或符號連結(symbolic link) |
FILE_ATTRIBUTE_SPARSE_FILE | 標示一個檔案是稀疏檔案。 |
FILE_ATTRIBUTE_SYSTEM | 標示一個檔案(或目錄)是一個系統檔案(或目錄)。 |
FILE_ATTRIBUTE_TEMPORARY | 標示一個檔案是臨時檔案。 |
FILE_ATTRIBUTE_VIRTUAL | 標示一個檔案是系統檔案。 |
要求
Minimum supported client Windows 2000 Professional
Minimum supported server Windows 2000 Server
Header WinBase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll
Unicode and ANSI names GetFileAttributesW (Unicode) and GetFileAttributesA (ANSI)