FILE_NAMES_INFORMATION 構造体 (ntifs.h)

[アーティクル]
02/27/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 エントリのバイトオフセット。このメンバーの後に他のエントリがない場合、このメンバーは 0 になります。

FileIndex

親ディレクトリ内のファイルのバイトオフセット。このメンバーは、NTFS などのファイルシステムでは未定義であり、親ディレクトリ内のファイルの位置は固定されず、並べ替え順序を維持するためにいつでも変更できます。

FileNameLength

ファイル名文字列の長さ。

FileName[1]

ファイル名文字列の最初の文字。その後、メモリ内で文字列の残りの部分が続きます。

注釈

この情報は、次のいずれかの方法で照会できます。

ZwQueryDirectoryFile を呼び出し、FileNamesInformationを FileInformationClass の値として渡し、呼び出し元によって割り当てられたFILE_NAMES_INFORMATION構造化バッファーを FileInformation の値として渡します。
メジャー関数コード IRP_MJ_DIRECTORY_CONTROLとマイナー関数コード IRP_MN_QUERY_DIRECTORYを含む IRP を作成します。

この情報を照会するために特定のアクセス権は必要ありません。

この構造体は、LONG (4 バイト) 境界に配置する必要があります。バッファーにこれらの構造体が 2 つ以上含まれている場合、各エントリの NextEntryOffset 値は、最後のを除き、4 バイトの境界になります。