NWGetObjectConnectionNumbers(3nw)


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

Synopsis

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

NWCCODE N_API NWGetObjectConnectionNumbers (NWCONN_HANDLE conn, pnstr8 objName, nuint16 objType, pnuint16 numConns, NWCONN_NUM N_FAR * connList, nuint16 maxConns);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

objName
(IN) Points to the bindery object name of the object whose network server connection numbers are being obtained.

objType
(IN) Specifies the bindery 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

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x89F0
WILD_CARD_NOT_ALLOWED

0x89FC
NO_SUCH_OBJECT

0x89FE
DIRECTORY_LOCKED

0x89FF
HARDWARE_FAILURE

Notices

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.

numConns is the number of connections the object has to the server. This value is used to index the array pointed to by connList. The following code fragment demonstrates the relationship between these two parameters.

   for(i=0; i<numberOfConnections; i++) printf("%d",connectionList[i]); 

Services

Connection

NCP calls

0x2222 23 17
Get File Server Information

0x2222 23 21
Get Object Connection List

0x2222 23 27
Get Object Connection List (if 3.11 server)

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