1NWGETCONNLISTFROMOBJECT(3NCP)                    NWGETCONNLISTFROMOBJECT(3NCP)
2
3
4

NAME

6       NWGetConnListFromObject - Retrieve connection list of specified object
7

SYNOPSIS

9       #include <nwcalls.h>
10
11       NWCCODE   NWGetConnListFromObject(NWCONN_HANDLE  conn,  nuint32  objID,
12       NWCONN_NUM firstConn, size_t* noOfReturnedConns, NWCONN_NUM* connList);
13
14

DESCRIPTION

16       This function  retrieves  connection  list  of  specified  object  from
17       server.
18
19       conn
20          conn  contains  connection  handle  obtained  from ncp_open(3ncp) or
21          NWParsePath(3ncp).
22
23       objID
24          objID contains server specific object ID. For bindery, it is  object
25          ID, for NDS objects it is local entry number.
26
27       firstConn
28          firstConn  specifies,  from  which connection start search. Use 0 on
29          first call and highest returned value on subsequent.
30
31       noOfReturnedConns
32          noOfReturnedConns contains number of returned connections. It may be
33          NULL,  there is no reason for pass NULL into this function.  At most
34          125 connections are returned at once.
35
36       connList
37          connList is array for returned connection numbers. It may  be  NULL,
38          in  this  case,  only noOfReturnedConns is returned.  connList array
39          must be able to hold 125 entries.
40
41

RETURN VALUE

43       Function returns zero on success and non-zero on failure.  If specified
44       object does not exist, success is returned and noOfReturnedConns is set
45       to zero.
46       If noOfReturnedConns is 125, it is possible that list is incomplete and
47       NWGetConnListFromObject should be invoked again for another set of con‐
48       nections.
49
50       See nwerrors(3ncp) for complete list of  error codes.
51
52
53

BUGS

55       None known.
56
57

SEE ALSO

59       nwerrors(3ncp), NWGetObjectConnectionNumbers(3ncp)
60
61
62
63libncp (>= 2.2.0.14)              04/13/1999     NWGETCONNLISTFROMOBJECT(3NCP)
Impressum