CompareFileTime function (fileapi.h)

Compares two file times.

Syntax

LONG CompareFileTime(
  [in] const FILETIME *lpFileTime1,
  [in] const FILETIME *lpFileTime2
);

Parameters

[in] lpFileTime1

A pointer to a FILETIME structure that specifies the first file time.

[in] lpFileTime2

A pointer to a FILETIME structure that specifies the second file time.

Return value

The return value is one of the following values.

Return value Description
-1
First file time is earlier than second file time.
0
First file time is equal to second file time.
1
First file time is later than second file time.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header fileapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also

FILETIME

File Times

GetFileTime

Time Functions