fileTIME 结构 (minwinbase.h)

  • 项目

包含一个 64 位值，该值表示自 1601 年 1 月 1 日 (UTC) 以来的 100 纳秒间隔数。

语法

typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME, *PFILETIME, *LPFILETIME;

成员

dwLowDateTime

文件时间的低序部分。

dwHighDateTime

文件时间的高阶部分。

注解

若要将 FILETIME 结构转换为易于向用户显示的时间，请使用 FileTimeToSystemTime 函数。

建议不要从 FILETIME 结构中添加和减去值来获取相对时间。 相反，应将文件时间的低位和高阶部分复制到 ULARGE_INTEGER 结构，对 QuadPart 成员执行 64 位算术，并将 LowPart 和 HighPart 成员复制到 FILETIME 结构中。

不要将指向 FILETIME 结构的指针强制转换为 ULARGE_INTEGER* 或 __int64* 值，因为这可能会导致 64 位 Windows 上的对齐错误。

并非所有文件系统都可以记录创建时间和上次访问时间，并非所有文件系统都以相同的方式记录它们。 例如，在 NT FAT 上，创建时间的分辨率为 10 毫秒，写入时间的分辨率为 2 秒，访问时间的分辨率为 1 天， (访问日期) 。 在 NTFS 上，访问时间的分辨率为 1 小时。 因此， GetFileTime 函数可能不会返回使用 SetFileTime 函数设置的相同文件时间信息。 此外，FAT 以本地时间记录磁盘上的时间。 但是，NTFS 以 UTC 格式记录磁盘上的时间。 有关详细信息，请参阅文件时间。

使用 FILETIME 结构的函数可以允许在 dwLowDateTime 和 dwHighDateTime 成员通常指定的零个值或正值之外的值。 例如， SetFileTime 函数使用 0xFFFFFFFF 来指定应保留文件的先前访问时间。 有关详细信息，请参阅要调用的函数的主题。

示例

有关示例，请参阅 将文件时间更改为当前时间 或 检索 Last-Write 时间。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
标头 minwinbase.h (包括 Windows.h)

另请参阅

CompareFileTime

文件时间

FileTimeToSystemTime

GetFileTime

ULARGE_INTEGER