Converts a local file time to a file time based on the Coordinated Universal Time (UTC).
Syntax
BOOL WINAPI LocalFileTimeToFileTime(
__in const FILETIME *lpLocalFileTime,
__out LPFILETIME lpFileTime
);
Parameters
- lpLocalFileTime [in]
-
A pointer to a
FILETIME structure that specifies the local file time to be converted into a UTC-based file time.
- lpFileTime [out]
-
A pointer to a
FILETIME structure to receive the converted UTC-based file time. This parameter cannot be the same as the lpLocalFileTime parameter.
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, use the
GetLastError function.
Remarks
LocalFileTimeToFileTime uses the current settings for the time zone and daylight saving time. Therefore, if it is daylight saving time, this function will take daylight saving time into account, even if the time you are converting is in standard time.
Requirements
| Minimum supported client | Windows 2000 Professional |
| Minimum supported server | Windows 2000 Server |
| Header | Winbase.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |
See Also
- FILETIME
- FileTimeToLocalFileTime
- Local Time
- Time Functions
Send comments about this topic to Microsoft
Build date: 11/19/2009