NWGetObjectConnectionNumbers

Returns a list of server connection numbers for clients logged in with the specified object name and type

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.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 NWGetObjectConnectionNumbers ( 
     NWCONN_HANDLE       conn,  
     const nstr8 N_FAR  *pObjName,  
     nuint16             objType,  
     pnuint16            numConns,  
     NWCONN_NUM N_FAR   *connList,  
     nuint16             maxConns);

Delphi

  uses calwin32 
   
  Function NWGetObjectConnectionNumbers 
    (connHandle : NWCONN_HANDLE; 
     const pObjName : pnstr8; 
     objType : nuint16; 
     pNumConns : pnuint16; 
     pConnHandleList : pNWCONN_NUM; 
     maxConns : nuint16 
  ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
pObjName
(IN) Points to the object name of the object whose network server connection numbers are being obtained.
objType
(IN) Specifies the object type of the object whose network server connection numbers are being returned.
numConns
(OUT) Points to the number of server connections for the specified object.
connList
(OUT) Points to an array of the server connection numbers for the specified object.
maxConns
(IN) Specifies the size of the connection list array (maximum length=50).

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

0x89F0

WILD_CARD_NOT_ALLOWED

0x89FE

DIRECTORY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

If no client is logged in using the specified object name and object type, the list length returned by the server is set to zero.

The numConns parameter value is used to index the array pointed to by the connList parameter.

If an invalid object name or object type is passed on a 3.x or above server, NWGetObjectConnectionNumbers will return SUCCESS and the numConns parameter will be zero indicating there are no connections with the server.

NCP Calls