NWGetFileServerDateAndTime(3nw)


NWGetFileServerDateAndTime -- returns the network date and time maintained on the specified NetWare server

Synopsis

   #include <nwserver.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWGetFileServerDateAndTime (NWCONN_HANDLE conn, pnuint8 pbuDateTimeBufB7);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

pbuDateTimeBufB7
(OUT) Points to a 7-byte buffer for the network date and time.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

Notices

To call NWGetFileServerDateAndTime, you must have console operator rights.

Since the date and time are not automatically synchronized across an internetwork, dates and times may differ among servers.

The system time clock is a 7-byte value defined in the following format:

Byte Value Range
0 Year 0 through 179
1 Month 1 through 12
2 Day 1 through 31
3 Hour 0 through 23 (0 = 12 midnight; 23 = 11 PM)
4 Minute 0 through 59
5 Second 0 through 59
6 Day of Week 0 through 6, 0=Sunday

 
 -------------------------------------------- 
| Byte|  Value      |  Range                | 
|-----|-------------|-----------------------| 
| 0   |  Year       |  0 through 179        | 
|-----|-------------|-----------------------| 
| 1   |  Month      |  1 through 12         | 
|-----|-------------|-----------------------| 
| 2   |  Day        |  1 through 31         | 
|-----|-------------|-----------------------| 
| 3   |  Hour       |  0 through 23 (0 = 12 | 
|     |             |  midnight; 23 = 11 PM)| 
|-----|-------------|-----------------------| 
| 4   |  Minute     |  0 through 59         | 
|-----|-------------|-----------------------| 
| 5   |  Second     |  0 through 59         | 
|-----|-------------|-----------------------| 
| 6   |  Day of Week|  0 through 6, 0=Sunday| 
|-----|-------------|-----------------------| 


NOTE: For the year value, 80-99 = 1980-199 9; 100-179 = 2000-2079. The range 0-79 applies to 1900-1979, but a year in this range should not be necessary. In fact, DOS cannot return a year value previous to 1980.

Services

File Server Environment

NCP calls

0x2222 20
Get File Server Date And Time

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.