(wdm.h) FILE_BASIC_INFORMATION 结构

项目
02/29/2024

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 函数将保留文件的当前设置。

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

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