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 位算术,并将 LowPartHighPart 成员复制到 FILETIME 结构中。

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

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

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

示例

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

要求

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

另请参阅

CompareFileTime

文件时间

FileTimeToSystemTime

GetFileTime

ULARGE_INTEGER