FILE_DIRECTORY_INFORMATION構造体 (ntifs.h)
FILE_DIRECTORY_INFORMATION 構造は、ディレクトリ内のファイルの詳細情報を照会するために使用されます。
構文
typedef struct _FILE_DIRECTORY_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;
WCHAR FileName[1];
} FILE_DIRECTORY_INFORMATION, *PFILE_DIRECTORY_INFORMATION;
メンバーズ
NextEntryOffset
バッファーに複数のエントリが存在する場合は、次の FILE_DIRECTORY_INFORMATION エントリのバイト オフセット。 このメンバーの後に他のエントリがない場合、このメンバーは 0 になります。
FileIndex
親ディレクトリ内のファイルのバイト オフセット。 このメンバーは、NTFS などのファイル システムでは未定義であり、親ディレクトリ内のファイルの位置は固定されず、並べ替え順序を維持するためにいつでも変更できます。
CreationTime
ファイルが作成された時刻。
LastAccessTime
ファイルが最後にアクセスされた時刻。
LastWriteTime
最後に情報がファイルに書き込まれた時刻。
ChangeTime
ファイルが最後に変更された時刻。
EndOfFile
ファイルの先頭からのバイト オフセットとしての新しいファイルの絶対位置。
EndOfFile は、ファイルの末尾へのバイト オフセットを指定します。 この値は 0 から始まるため、実際にはファイル内の最初の空きバイトを参照します。 つまり、endOfFile
AllocationSize
ファイルの割り当てサイズ (バイト単位)。 通常、この値は、基になる物理デバイスのセクターまたはクラスター サイズの倍数です。
FileAttributes
ファイル属性。次の任意の有効な組み合わせにすることができます。
- FILE_ATTRIBUTE_ARCHIVE
- FILE_ATTRIBUTE_COMPRESSED
- FILE_ATTRIBUTE_DIRECTORY
- FILE_ATTRIBUTE_HIDDEN
- FILE_ATTRIBUTE_NORMAL
- FILE_ATTRIBUTE_READONLY
- FILE_ATTRIBUTE_SYSTEM
- FILE_ATTRIBUTE_TEMPORARY
FileNameLength
ファイル名文字列の長さを指定します。
FileName[1]
ファイル名文字列の最初の文字を指定します。 その後、メモリ内で文字列の残りの部分が続きます。
備考
この情報は、次のいずれかの方法で照会できます。
ZwQueryDirectoryFile 渡し、呼び出し元によって割り当てられたFILE_DIRECTORY_INFORMATION構造化バッファー FileInformation の値として渡します。- メジャー関数コード IRP_MJ_DIRECTORY_CONTROLとマイナー関数コード IRP_MN_QUERY_DIRECTORYを含む IRP を作成します。
この情報を照会するために、特定のアクセス権は必要ありません。
すべての日付と時刻は、システム時刻の絶対形式です。 絶対システム時間は、1601 年の開始以降の 100 ナノ秒間隔の数です。
この構造体は、LONGLONG (8 バイト) 境界に配置する必要があります。 バッファーにこれらの構造体が 2 つ以上含まれている場合、NextEntryOffset 各エントリの値 (最後を除く) は 8 バイトの境界に置きます。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ntifs.h (Ntifs.h、Fltkernel.h を含む) |