SystemTimeToFileTime 函数 (timezoneapi.h)

将系统时间转换为文件时间格式。系统时间基于协调世界时 (UTC) 。

语法

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

[in] lpSystemTime

指向 SYSTEMTIME 结构的指针，该结构包含要从 UTC 转换为文件时间格式的系统时间。

将忽略 SYSTEMTIME 结构的 wDayOfWeek 成员。

[out] lpFileTime

指向 FILETIME 结构的指针，用于接收转换的系统时间。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注意

False 返回值可以指示传递的 SYSTEMTIME 结构表示无效的日期。某些情况（例如在闰年中添加的附加日期）可能会导致应用程序逻辑意外地创建无效日期。有关避免这些问题的详细信息，请参阅闰年就绪情况。