FileTimeToSystemTime

FileTimeToSystemTime converts a file time to system time format. System time is based on Coordinated Universal Time (UTC).

Syntax

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

Parameters

lpFileTime

Pointer to a FILETIME structure containing the file time to be converted to system date and time (UTC) format.

The FileTimeToSystemTime function works only with lpFileTime ->dwHighDateTime values that are less than or equal to 600000000.

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) .

To get extended error information, call GetLastError.

Remarks

The function fails if the value of dwHighDateTime field in FILETIME structure is greater than 600000000.

Requirements