FILE_NAMES_INFORMATION結構 (ntifs.h)

發行項
02/29/2024

用來查詢目錄中檔名詳細資訊 的FILE_NAMES_INFORMATION 結構。

語法

typedef struct _FILE_NAMES_INFORMATION {
  ULONG NextEntryOffset;
  ULONG FileIndex;
  ULONG FileNameLength;
  WCHAR FileName[1];
} FILE_NAMES_INFORMATION, *PFILE_NAMES_INFORMATION;

成員

NextEntryOffset

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

FileIndex

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

FileNameLength

檔名字串的長度。

FileName[1]

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

備註

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

呼叫 ZwQueryDirectoryFile，將 FileNamesInformation 當做 FileInformationClass 的值傳遞，並傳遞呼叫端配置的已配置、 FILE_NAMES_INFORMATION結構化緩衝區作為 FileInformation 的值。
使用主要函式程式碼建立 IRP IRP_MJ_DIRECTORY_CONTROL和次要函式程式碼IRP_MN_QUERY_DIRECTORY。

查詢此資訊不需要任何特定的訪問許可權。

此結構必須對齊 LONG (4 位元組) 界限。如果緩衝區包含這兩個以上的結構，則每個專案中的 NextEntryOffset 值，但最後一個值落在 4 位元組的界限上。