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