FileTimeToLocalFileTime

This function converts a file time based on the Coordinated Universal Time (UTC) to a local file time.

At a Glance

Header file: Winbase.h
Windows CE versions: 1.0 and later

Syntax

BOOL FileTimeToLocalFileTime( const FILETIME *lpFileTime,
LPFILETIME
lpLocalFileTime );

Parameters

lpFileTime

[in] Pointer to a FILETIME structure containing the UTC-based file time to be converted into a local file time.

lpLocalFileTime

[out] Pointer to a FILETIME structure to receive the converted local file time. This parameter cannot be the same as the lpFileTime parameter.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

FileTimeToLocalFileTime 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.

See Also

FILETIME, LocalFileTimeToFileTime