FILE_STAT_BASIC_INFORMATION 構造体 (ntifs.h)
FILE_STAT_BASIC_INFORMATION には、ファイルに関する基本的なメタデータが含まれています。
構文
typedef struct _FILE_STAT_BASIC_INFORMATION {
LARGE_INTEGER FileId;
LARGE_INTEGER CreationTime;
LARGE_INTEGER LastAccessTime;
LARGE_INTEGER LastWriteTime;
LARGE_INTEGER ChangeTime;
LARGE_INTEGER AllocationSize;
LARGE_INTEGER EndOfFile;
ULONG FileAttributes;
ULONG ReparseTag;
ULONG NumberOfLinks;
ULONG DeviceType;
ULONG DeviceCharacteristics;
ULONG Reserved;
LARGE_INTEGER VolumeSerialNumber;
FILE_ID_128 FileId128;
} FILE_STAT_BASIC_INFORMATION, *PFILE_STAT_BASIC_INFORMATION;
メンバー
FileId
ファイルの ID を指定します。
CreationTime
ファイルの作成時刻を指定します。
LastAccessTime
ファイルが最後にアクセスされた時刻を指定します。
LastWriteTime
ファイルが最後に書き込まれた時刻を指定します。
ChangeTime
ファイルが最後に変更された時刻を指定します。
AllocationSize
ファイル割り当てサイズ (バイト単位)。 通常、この値は、基になる物理デバイスのセクターまたはクラスター サイズの倍数です。
EndOfFile
ファイルの先頭からのバイト オフセットとしての新しいファイルの絶対位置。 EndOfFile は、ファイルの末尾へのバイト オフセットを指定します。 この値は 0 から始まるため、実際にはファイル内の最初のフリー バイトを参照します。 言い換えると、 EndOfFile は、ファイル内の最後の有効なバイトの直後のバイトへのオフセットです。
FileAttributes
ファイル属性。次の任意の有効な組み合わせにすることができます。
| 属性 | 値 |
|---|---|
| FILE_ATTRIBUTE_READONLY | 0x00000001 |
| FILE_ATTRIBUTE_HIDDEN | 0x00000002 |
| FILE_ATTRIBUTE_SYSTEM | 0x00000004 |
| FILE_ATTRIBUTE_DIRECTORY | 0x00000010 |
| FILE_ATTRIBUTE_ARCHIVE | 0x00000020 |
| FILE_ATTRIBUTE_NORMAL | 0x00000080 |
ReparseTag
ポイント タグを再解析します。 詳細については、「 再解析ポイントについて 」を参照してください。
NumberOfLinks
ファイルへのリンクの数を指定します。
DeviceType
基になるデバイスの種類に応じて、ドライバーが IoCreateDevice を呼び出すタイミングを設定します。 詳細については、「 デバイスの種類の指定」を参照してください。
DeviceCharacteristics
デバイスの特性。 関連する値の説明については、「 DEVICE_OBJECT」を参照してください。
Reserved
システムで使用するために予約されています。
VolumeSerialNumber
ファイルが配置されているボリュームのシリアル番号。
FileId128
ファイルの 128 バイトのファイル参照番号。 この番号は、ファイル システムによって生成され、ファイルに割り当てられます。
注釈
この情報は、次のいずれかの方法で照会できます。
ZwQueryDirectoryFile を呼び出し、FileStatBasicInformation をFileInformationClass の値として渡し、呼び出し元によって割り当てられたFILE_ID_EXTD_DIR_INFORMATION構造化バッファーを FileInformation の値として渡します。
主要な関数コードIRP_MJ_DIRECTORY_CONTROLとマイナー関数コードIRP_MN_QUERY_DIRECTORYを含む IRP をCreateします。
この情報を照会するために、特定のアクセス権は必要ありません。
ファイル参照番号 (ファイル ID とも呼ばれます) は、静的ファイル システム内でのみ一意であることが保証されます。 ファイル システムは自由に再利用できるため、時間の経過と同時に一意であるとは限りません。 また、一定の状態を保つ保証もありません。 たとえば、FAT ファイル システムは、ディスク上のファイルのディレクトリ エントリ レコード (DIRENT) のバイト オフセットからファイルのファイル参照番号を生成します。 デフラグによって、このバイト オフセットが変更される可能性があります。 したがって、FAT ファイル参照番号は時間の経過と同時に変化する可能性があります。
すべての日付と時刻は、システム時刻の絶対形式です。 絶対システム時間は、1601 年の開始以降の 100 ナノ秒間隔の数です。
この構造体は、LONGLONG (8 バイト) 境界に配置する必要があります。 バッファーにこれらの構造体が 2 つ以上含まれている場合、各エントリの NextEntryOffset 値 (最後を除く) は 8 バイトの境界になります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 11バージョン 24H2 |
| Header | ntifs.h |