FILE_FULL_DIR_INFO結構 (winbase.h)

包含檔案的目錄資訊。 當FileFullDirectoryInfoFileFullDirectoryRestartInfo傳入FileInformationClass參數時,會從 GetFileInformationByHandleEx函式傳回這個結構。

語法

typedef struct _FILE_FULL_DIR_INFO {
  ULONG         NextEntryOffset;
  ULONG         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  ULONG         FileAttributes;
  ULONG         FileNameLength;
  ULONG         EaSize;
  WCHAR         FileName[1];
} FILE_FULL_DIR_INFO, *PFILE_FULL_DIR_INFO;

成員

NextEntryOffset

傳回之下一 個FILE_FULL_DIR_INFO 結構的位移。 如果沒有其他專案遵循此專案,則包含零 (0) 。

FileIndex

父目錄中檔案的位元組位移。 這個成員未定義給檔案系統,例如 NTFS,其中父目錄內的檔案位置不是固定的,而且可以隨時變更以維護排序次序。

CreationTime

建立檔案的時間。

LastAccessTime

上次存取檔案的時間。

LastWriteTime

上次寫入檔案的時間。

ChangeTime

上次變更檔案的時間。

EndOfFile

從檔案開頭到檔案預設資料流程結尾的絕對新檔案結尾位置做為位元組位移。 因為這個值是以零起始,所以實際上會參考檔案中的第一個可用位元組。 換句話說, EndOfFile 是緊接在檔案中最後一個有效位元組的位元組位移。

AllocationSize

為檔案配置的位元組數目。 此值通常是基礎實體裝置的磁區或叢集大小的倍數。

FileAttributes

檔案屬性。 此成員可以是下列屬性的任何有效組合:

FILE_ATTRIBUTE_ARCHIVE (0x00000020)

FILE_ATTRIBUTE_COMPRESSED (0x00000800)

FILE_ATTRIBUTE_DIRECTORY (0x00000010)

FILE_ATTRIBUTE_HIDDEN (0x00000002)

FILE_ATTRIBUTE_NORMAL (0x00000080)

FILE_ATTRIBUTE_READONLY (0x00000001)

FILE_ATTRIBUTE_SYSTEM (0x00000004)

FILE_ATTRIBUTE_TEMPORARY (0x00000100)

FileNameLength

檔案名的長度。

EaSize

檔案的擴充屬性大小。

FileName[1]

檔案名字串的第一個字元。 這會接著在記憶體中加上字串的其餘部分。

備註

FILE_FULL_DIR_INFO結構是FILE_ID_BOTH_DIR_INFO結構中資訊的子集。 如果不需要其他資訊,則作業會更快,因為它來自目錄專案; FILE_ID_BOTH_DIR_INFO 包含目錄專案和主要檔案資料表 (MFT) 的資訊。

查詢這項資訊不需要特定存取權限。

所有日期和時間都是絕對系統時間格式。 絕對系統時間是自 1601 年開始以來的 100 奈秒間隔數目。

這個 FILE_FULL_DIR_INFO 結構必須對齊 LONGLONG (8 位元組) 界限。 如果緩衝區包含兩個或多個這些結構,則每個專案中的 NextEntryOffset 值會落在 8 位元組界限上,但最後一個專案除外。

若要編譯使用此結構的應用程式,請將_WIN32_WINNT巨集定義為 0x0600 或更新版本。 如需詳細資訊,請參閱 使用 Windows 標頭

規格需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
標頭 winbase.h (包含 Windows.h)

另請參閱

FILE_INFO_BY_HANDLE_CLASS

檔案管理結構

GetFileInformationByHandleEx