SystemTimeToFileTime

The SystemTimeToFileTime function converts a SYSTEMTIME structure to a FILETIME structure.

Syntax


BOOL SystemTimeToFileTime(
  const SYSTEMTIME *lpSystemTime,
  LPFILETIME       lpFileTime
);

Parameters

lpSystemTime
A pointer to a SYSTEMTIME structure that contains the date and time to be converted. The structure members must contain valid values.
lpFileTime
A pointer to a FILETIME structure that receives the converted date and time.

Return Value

If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The FILETIME structure represents the number of 100-nanosecond intervals since January 1, 1601 (UTC).

This function converts a local time specified in SYSTEMTIME to a FILETIME value. For converting UTC time, use the SystemTimeToTzSpecificLocalTime function.

Requirements


Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Header	`winbase.h` (include `windows.h`)
Library	`Kernel32.lib`
DLL	`Kernel32.dll`

Windows API Reference