FileTimeToSystemTime

FileTimeToSystemTime converts a 64-bit file time to system time format.

Syntax

BOOL FileTimeToSystemTime(
    [in]    const FILETIME* lpFileTime,
    [out]   LPSYSTEMTIME lpSystemTime
); 

Parameters

[in] lpFileTime

Pointer to a FILETIME structure containing the file time to convert to system date and time format.

The FileTimeToSystemTime function works only with FILETIME values that are less than 0x8000000000000000. The function fails with values equal to or greater than that.

[out] lpSystemTime

Pointer to a SYSTEMTIME structure to receive the converted file time.

Return Value

If the function succeeds, it returns a non-zero value. If the function fails, it returns 0 (zero). Call GetLastError to get extended error information.

Remarks

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

Requirements