DosSetDateTime

Bindings:  C, MASM 

This call is used to set the date and time that are maintained by the 
operating system. 

 DosSetDateTime     (DateTime) 
 

 DateTime (PDATETIME) - input 
    Address of the date and time structure: 

    hours (UCHAR) 
       Current hour (0-23). 

    minutes (UCHAR) 
       Current minute (0-59). 

    seconds (UCHAR) 
       Current second (0-59). 

    hundredths (UCHAR) 
       Current hundredth of a second (0-99). 

    day (UCHAR) 
       Current day (1-31). 

    month (UCHAR) 
       Current month (1-12). 

    year (USHORT) 
       Current year (1980-2079). 

    timezone (SHORT) 
       Minutes west of UTC (Universal Time Coordinate -720 to 720). 

    weekday (UCHAR) 
       Current day of the week. This value is ignored and is calculated 
       from the other parameter information. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    327       ERROR_TS_DATETIME 
 
 Remarks 

 The value of timezone is the difference in minutes between the current 
 time zone and UTC. This is a positive number if earlier than UTC, and 
 negative number if it is later. For Eastern Standard Time this value is 
 300 (five hours earlier than UTC). 

 To get the date and time, issue DosGetDateTime. If the application is 
 executing in the OS/2 environment, it is more efficient to obtain these 
 variables by calling DosGetInfoSeg instead of this function. However, 
 applications written to the family API cannot depend on the availability 
 of DosGetInfoSeg. 

 Not adhering to the limits on any of the parameters results in the return 
 code being set to rc = 327 (ERROR_TS_DATETIME). Also, OS/2 verifies that 
 the day is possible for the month and the year (even for leap year).  If 
 the day is not reasonable, OS/2 will also set rc = 327.