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

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objbase.h.
  Import Library: Included as a resource in ole32.dll.

See Also

CoFileTimeToDosDateTime, CoFileTimeNow