FILE_BOTH_DIR_INFORMATION 結構 (ntifs.h)

FILE_BOTH_DIR_INFORMATION 結構可用來查詢目錄中檔案的詳細資訊。

語法

typedef struct _FILE_BOTH_DIR_INFORMATION {
  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;
  CCHAR         ShortNameLength;
  WCHAR         ShortName[12];
  WCHAR         FileName[1];
} FILE_BOTH_DIR_INFORMATION, *PFILE_BOTH_DIR_INFORMATION;

成員

NextEntryOffset

如果緩衝區中有多個專案，則下一個FILE_BOTH_DIR_INFORMATION專案的位元組位移。 如果沒有其他專案遵循此成員，則此成員為零。

FileIndex

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

CreationTime

建立檔案的時間。

LastAccessTime

上次存取檔案的時間。

LastWriteTime

上次將資訊寫入檔案。

ChangeTime

上次變更檔案的時間。

EndOfFile

絕對新的檔案結尾位置，做為檔案開頭的位元組位移。 EndOfFile 會指定檔案結尾的位元組位移。 因為這個值是以零起始，所以實際上會參考檔案中的第一個可用位元組。 換句話說， EndOfFile 是位移緊接在檔案中最後一個有效位元組之後的位元組。

AllocationSize

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

FileAttributes

檔案屬性，可以是下列任何有效組合：

• FILE_ATTRIBUTE_READONLY
• FILE_ATTRIBUTE_HIDDEN
• FILE_ATTRIBUTE_SYSTEM
• FILE_ATTRIBUTE_DIRECTORY
• FILE_ATTRIBUTE_ARCHIVE
• FILE_ATTRIBUTE_DEVICE
• FILE_ATTRIBUTE_NORMAL
• FILE_ATTRIBUTE_TEMPORARY
• FILE_ATTRIBUTE_SPARSE_FILE
• FILE_ATTRIBUTE_REPARSE_POINT
• FILE_ATTRIBUTE_COMPRESSED
• FILE_ATTRIBUTE_OFFLINE
• FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
• FILE_ATTRIBUTE_ENCRYPTED

FileNameLength

指定檔名字串的長度，以位元組為單位。

EaSize

檔案 (EA) 擴充屬性的合併長度，以位元組為單位。

ShortNameLength

指定簡短檔名字符串的長度，以位元組為單位。

ShortName[12]

Unicode 字串，其中包含檔案的簡短 (8.3) 名稱。

FileName[1]

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

備註

您可以使用下列任一種方式來查詢此資訊：

• 呼叫 ZwQueryDirectoryFile，傳遞 FileBothDirectoryInformation 做為 FileInformationClass 的值，並傳遞呼叫端配置的呼叫端配置，FILE_BOTH_DIR_INFORMATION結構化緩衝區做為 FileInformation 的值。

• 建立具有主要函式程式代碼的 IRP IRP_MJ_DIRECTORY_CONTROL和次要函式程式代碼IRP_MN_QUERY_DIRECTORY。

查詢這項資訊不需要特定訪問許可權。

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

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

規格需求

需求	值
標頭	ntifs.h (包括 Ntifs.h、Fltkernel.h)

另請參閱

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile