The FileTimeToSystemTime function converts a 64-bit file time to system time format.
BOOL FileTimeToSystemTime(
| CONST FILETIME *lpFileTime, | // pointer to file time to convert |
| LPSYSTEMTIME lpSystemTime | // pointer to structure to receive system time |
| ); |
Parameters
lpFileTime
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
Pointer to a SYSTEMTIME structure to receive the converted file time.
Return Values
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
As noted above, the function fails for FILETIME values that are equal to or greater than 0x8000000000000000.
See Also
DosDateTimeToFileTime, FILETIME, FileTimeToDosDateTime, SYSTEMTIME, SystemTimeToFileTime