(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
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.