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 指定到文件末尾的字节偏移量。 由于此值从零开始，因此它实际上引用文件中的第一个可用字节。 换句话说， EndOfFile 是紧跟在文件中最后一个有效字节之后的字节的偏移量。

FileAttributes

文件属性，可以是以下各项的任意有效组合：

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 Create IRP。

无需特定访问权限即可查询此信息。

文件引用号（也称为文件 ID）保证仅在静态文件系统中是唯一的。 它们不保证随时间推移是唯一的，因为文件系统可以自由重复使用它们。 也不保证它们保持不变。 例如，FAT 文件系统从磁盘上的 DIRENT) 文件目录条目记录的字节偏移量 (生成文件引用号。 碎片整理可以更改此字节偏移量。 因此，FAT 文件引用编号可能会随时间而变化。

所有日期和时间均采用绝对系统时间格式。 绝对系统时间是自 1601 年初以来的 100 纳秒间隔数。

此结构必须在 LONGLONG (8 字节) 边界上对齐。 如果缓冲区包含其中两个或更多个结构，则每个条目中的 NextEntryOffset 值（最后一个除外）位于 8 字节边界上。

要求

另请参阅

FILE_INFORMATION_CLASS

**ZwQueryInformationByName **