FILE_ID_64_EXTD_DIR_INFORMATION 结构 (ntifs.h)

FILE_ID_64_EXTD_DIR_INFORMATION 结构用于查询目录中文件的 64 位文件引用编号信息。

语法

typedef struct _FILE_ID_64_EXTD_DIR_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;
  ULONG         EaSize;
  ULONG         ReparsePointTag;
  LARGE_INTEGER FileId;
  WCHAR         FileName[1];
} FILE_ID_64_EXTD_DIR_INFORMATION, *PFILE_ID_64_EXTD_DIR_INFORMATION;

成员

NextEntryOffset

如果缓冲区中存在多个条目,则下一 个FILE_ID_64_EXTD_DIR_INFORMATION 项的字节偏移量。 如果此成员后面没有其他条目,则此成员为零。

FileIndex

文件在父目录中的字节偏移量。 对于文件系统(如 NTFS),此成员未定义,其中文件在父目录中的位置不是固定的,可以随时更改以保持排序顺序。

CreationTime

文件的创建时间。

LastAccessTime

上次访问文件的时间。

LastWriteTime

上次将信息写入文件的时间。

ChangeTime

上次更改文件的时间。

EndOfFile

绝对新的文件结尾位置,作为文件开头的字节偏移量。 EndOfFile 指定到文件末尾的字节偏移量。 由于此值从零开始,因此它实际上引用文件中的第一个可用字节。 换句话说, EndOfFile 是紧随文件中最后一个有效字节之后的字节的偏移量。

AllocationSize

文件分配大小(以字节为单位)。 通常,此值是基础物理设备的扇区或群集大小的倍数。

FileAttributes

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

  • FILE_ATTRIBUTE_READONLY
  • FILE_ATTRIBUTE_HIDDEN
  • FILE_ATTRIBUTE_SYSTEM
  • FILE_ATTRIBUTE_DIRECTORY
  • FILE_ATTRIBUTE_ARCHIVE
  • FILE_ATTRIBUTE_NORMAL
  • FILE_ATTRIBUTE_TEMPORARY
  • FILE_ATTRIBUTE_COMPRESSED

FileNameLength

指定文件名字符串的长度(以字节为单位)。

EaSize

文件的扩展属性 (EA) 的组合长度(以字节为单位)。

ReparsePointTag

重分析点的标记值。

FileId

文件的 64 位文件引用号。 此数字由文件系统生成并分配给该文件。

FileName[1]

指定文件名字符串的第一个字符。 这在内存中后跟字符串的其余部分。

注解

可以通过以下任一方式查询此信息:

  • 调用 ZwQueryDirectoryFile,将 FileIdExtdDirectoryInformation 作为 FileInformationClass 的值传递,并将调用方分配 的FILE_ID_EXTD_DIR_INFORMATION结构化缓冲区作为 FileInformation 的值传递。

  • 创建包含主要函数代码 IRP_MJ_DIRECTORY_CONTROL 和次要函数代码IRP_MN_QUERY_DIRECTORY的 IRP。

查询此信息不需要任何特定的访问权限。

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

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

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

要求

要求
最低受支持的客户端 Windows 11,版本 23H2
标头 ntifs.h

另请参阅

FILE_INFORMATION_CLASS

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile