FileTimeToSystemTime
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