Converts a file time to system time format.

Syntax

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

Parameters

lpFileTime [in]

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

This value must be less than 0x8000000000000000. Otherwise, the function fails.

lpSystemTime [out]

A pointer to a SYSTEMTIME structure to receive the converted file time.

Return Value

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.

Examples

For an example, see Retrieving the Last-Write Time.

Requirements

See Also

DosDateTimeToFileTime
File Times
FILETIME
FileTimeToDosDateTime
SYSTEMTIME
SystemTimeToFileTime
Time Functions

Send comments about this topic to Microsoft

Build date: 10/2/2008