FILE_BASIC_INFORMATION结构（wdm.h）

项目
02/07/2025

FILE_BASIC_INFORMATION 结构包含文件的时间戳和基本属性。它用作查询或设置文件信息的例程的参数。

语法

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

成员

CreationTime

指定创建文件的时间。

LastAccessTime

指定上次访问文件的时间。

LastWriteTime

指定文件上次写入到的时间。

ChangeTime

指定上次更改文件的时间。

FileAttributes

指定一个或多个FILE_ATTRIBUTE_XXX 标志。有关这些标志的说明，请参阅 Microsoft Windows SDK 中的文件属性常量。

言论

无法设置或返回FILE_ATTRIBUTE_NORMAL标志与其他任何属性。所有其他 FileAttributes 值都覆盖此属性。

CreationTime、LastAccessTime、LastWriteTime的时间值，ChangeTime 以绝对系统时间格式表示。绝对系统时间是公历 1601 年初以来的 100 纳秒间隔数。

如果为 FILE_BASIC_INFORMATION 结构的任何 XxxTime 成员指定零值，则 ZwSetInformationFile 函数将保留文件的当前设置。

文件系统更新 LastAccessTime、LastWriteTime的值，并在对文件执行 I/O作后根据需要 ChangeTime 成员。驱动程序或应用程序可以通过将适当的成员设置为 -1 来请求文件系统不更新对调用方的文件句柄执行的 I/O作的一个或多个成员。调用方可以将这三个成员的一个、全部或任何其他组合设置为 -1。只有设置为 -1 的成员不受文件句柄上的 I/O作的影响;其他成员将根据需要进行更新。在 NTFS 和 ReFS 系统上，可以通过将相应的成员（s）设置为 -2 来还原文件句柄上的时间戳更新。

若要设置此结构的成员，调用方必须具有对文件FILE_WRITE_ATTRIBUTES访问权限。