FileTimeToSystemTime

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

At a Glance

Header file: Winbase.h
Windows CE versions: 1.0 and later

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 Values

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

Remarks

As noted above, the function fails for FILETIME values that are equal to or greater than 0x8000000000000000.

See Also

FILETIME, SYSTEMTIME, SystemTimeToFileTime