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.