GetFileAttributes

函式GetFileAttributes 為一個指定的檔案或目錄返回檔案系統的屬性。可以使用GetFileAttributesEx 函式獲得更多的屬性信息。如果要實現互動式操作,可以使用GetFileAttributesTransacted 函式。

基本介紹

  • 中文名:GetFileAttributes
  • 外文名:GetFileAttributes
  • 詞性:名詞
  • 分類:函式
基本信息,參數,返回值,備註,

基本信息

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)

相關詞條

熱門詞條

聯絡我們