FileTimeToSystemTime

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function converts a 64-bit file time to system time format.

Syntax

BOOL FileTimeToSystemTime(
  const FILETIME* lpFileTime,
  LPSYSTEMTIME lpSystemTime
);

Parameters

  • lpFileTime
    [in] Pointer to a FILETIME structure containing the file time to convert to system date and time format.

    The FileTimeToSystemTime function only works with FILETIME values that are less than 0x8000000000000000.

    The function fails with values equal to or greater than that.

  • lpSystemTime
    [out] Pointer to a SYSTEMTIME structure to receive the converted file time.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The function fails for FILETIME values that are equal to or greater than 0x8000000000000000.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Time Functions
SystemTimeToFileTime
FILETIME
SYSTEMTIME

Other Resources