Remote Utilities Category

The function in the Remote Utilities category enables applications to access the time-of-day information on a remote server.

Function	Description
NetRemoteTOD	Returns a server’s time of day.

The NetRemoteTOD function returns time-of-day information from a remote server.

Remote Utilities Category Data Structures

The Remote Utilities function (NetRemoteTOD) returns structure data.

Time of Day Information

The time_of_day_info data structure, shown below, is returned by the NetRemoteTOD function.

struct time_of_day_info {

unsigned long tod_elapsedt;

unsigned long tod_msecs;

unsigned char tod_hours;

unsigned char tod_mins;

unsigned char tod_secs;

unsigned char tod_hunds;

unsigned short tod_timezone;

unsigned short tod_tinterval;

unsigned char tod_day;

unsigned char tod_month;

unsigned short tod_year;

unsigned char tod_weekday;

};

Within this structure, the following parameters are defined:

tod_elapsedt tells how many seconds have elapsed since 00:00:00, January 1, 1970.

tod_msecs tells the current millisecond.

tod_hours tells the current hour.

tod_mins tells the current minute.

tod_secs tells the current second.

tod_hunds tells the current hundredths of a second.

tod_timezone tells the time zone of the server; calculated (in minutes) from the Greenwich Mean Time (GMT) zone.

tod_tinterval tells the time interval for each tick of the clock. Each integral integer represents 0.0001 second.

tod_day (1-31) tells the day of the month.

tod_month (1-12) tells the month.

tod_year tells the year, starting with 1980.

tod_weekday tells the day of the week (0=Sunday, 6=Saturday).