NWGetConnectionInformation(3nw)


NWGetConnectionInformation -- returns information about a logged in object

Synopsis

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

NWCCODE N_API NWGetConnectionInformation (NWCONN_HANDLE conn, NWCONN_NUM connNumber, pnstr8 objName, pnuint16 objType, pnuint16 objID, pnuint8 loginTime);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

connNumber
(IN) Specifies the NetWare server connection number for which the information is being obtained.

objName
(OUT) Points to the name of the object whose connection number is passed in connNumber (48 bytes, optional).

objType
(OUT) Points to the client's bindery object type (optional).

objID
(OUT) Points to the client's bindery object ID (optional).

loginTime
(OUT) Points to the time value when the object logged in at the specified connection number (7 bytes long, optional).

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x89FC
NO_SUCH_OBJECT

0x89FD
BAD_STATION_NUMBER

0x89FE
DIRECTORY_LOCKED

0x89FF
HARDWARE_FAILURE

Notices

objName, objType, objID, and loginTime are included in the returned information.

The system time clock is a 7-byte value contained in loginTime and defined in the following format.

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

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


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

Services

Connection

NCP calls

0x2222 23 17
Get File Server Information

0x2222 23 22
Get Station's Logged Info (old)

0x2222 23 28
Get Station's Logged Inf.

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