# CoDosDateTimeToFileTime

Converts the MS-DOS representation of the time and date to a FILETIME structure, which Win32 uses to determine the date and time.

BOOL CoDosDateTimeToFileTime(

WORD nDosDate, | //16-bit MS-DOS date
WORD nDosTime, | //16-bit MS-DOS time
FILETIME * lpFileTime | //Pointer to the structure
); |

Parameters

nDosDate
  [in] 16-bit MS-DOS date.
nDosTime
  [in] 16-bit MS-DOS time.
lpFileTime
  [out] Pointer to the FILETIME structure.

Return Values

TRUE
  The FILETIME structure was created successfully.
FALSE
  The FILETIME structure was not created successfully, probably because of invalid arguments.

Remarks

The FILETIME structure and the CoDosDateTimeToFileTime and CoFileTimeToDosDateTime functions are part of the Win32 API definition. They are provided for compatibility in all OLE implementations, but are redundant on Win32 platforms.

MS-DOS records file dates and times as packed 16-bit values. An MS-DOS date has the following format:

Bits | Contents
0-4 | Days of the month (1-31).
5-8 | Months (1 = January, 2 = February, and so forth).
9-15 | Year offset from 1980 (add 1980 to get actual year).

An MS-DOS time has the following format:

Bits | Contents
0-4 | Seconds divided by 2.
5-10 | Minutes (0-59).
11-15 | Hours (0-23 on a 24-hour clock).

See Also

CoFileTimeToDosDateTime, CoFileTimeNow