NWGetConnectionInformation

Returns information about a logged in object

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Connection

Syntax

C

  #include <nwconnec.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWGetConnectionInformation ( 
     NWCONN_HANDLE   connHandle,  
     nuint16         connNumber,  
     pnstr8          pObjName,  
     pnuint16        pObjType,  
     pnuint32        pObjID,  
     pnuint8         pLoginTime);

Delphi

  uses calwin32 
   
  Function NWGetConnectionInformation 
    (connHandle : NWCONN_HANDLE; 
     connNumber : nuint16; 
     pObjName : pnstr8; 
     pObjType : pnuint16; 
     pObjID : pnuint32; 
     pLoginTime : pnuint8 
  ) : NWCCODE;

Parameters

connHandle
(IN) Specifies the NetWare server connection handle.
connNumber
(IN) Specifies the NetWare server connection number for which the information is being obtained.
pObjName
(OUT) Points to the name of the object whose connection number is passed in connNumber (48 bytes, optional).
pObjType
(OUT) Points to the object type of the client (optional).
pObjID
(OUT) Points to the object ID of the client (optional).
pLoginTime
(OUT) Points to the time value when the object logged in at the specified connection number (7 bytes, optional).

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

0x89FB

INVALID_PARAMETERS: Connection needs to be authenticated

0x89FC

NO_SUCH_OBJECT

0x89FD

BAD_STATION_NUMBER

0x89FE

DIRECTORY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

The pObjName, pObjType, pObjID, and pLoginTime parameter are included in the returned information.

The system time clock is a 7-byte value contained in the pLoginTime parameter 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 since DOS cannot return a year value previous to 1980.

NCP Calls

See Also

NWCCGetAllConnInfo, NWGetUserInfo (Server Management)