Converts a system time to file time format. System time is based on Coordinated Universal Time (UTC).
Syntax
BOOL WINAPI SystemTimeToFileTime(
__in const SYSTEMTIME *lpSystemTime,
__out LPFILETIME lpFileTime
);
Parameters
- lpSystemTime [in]
-
A pointer to a
SYSTEMTIME structure that contains the system time to be converted from UTC to file time format.
The wDayOfWeek member of the
SYSTEMTIME structure is ignored.
- lpFileTime [out]
-
A pointer to a
FILETIME structure to receive the converted system 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
Changing a File Time to the Current 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
- DosDateTimeToFileTime
- FILETIME
- FileTimeToDosDateTime
- FileTimeToSystemTime
- System Time
- SYSTEMTIME
- Time Functions
Send comments about this topic to Microsoft
Build date: 11/19/2009