1NWGETOBJECTCONNECTIONNUMBERS(3NCP) NWGETOBJECTCONNECTIONNUMBERS(3NCP)
2
3
4
6 NWGetObjectConnectionNumbers - Retrieve connection list of specified
7 object
8
10 #include <nwcalls.h>
11
12 NWCCODE NWGetObjectConnectionNumbers(NWCONN_HANDLE conn, const char*
13 name, nuint16 type, size_t* noOfReturnedConns, NWCONN_NUM* connList,
14 size_t maxConns);
15
16
18 This function retrieves connection list of specified object from
19 server.
20
21 conn
22 conn contains connection handle obtained from ncp_open(3ncp) or
23 NWParsePath(3ncp).
24
25 name
26 name contains bindery object name. Wildcards are not supported.
27 Must not be NULL.
28
29 type
30 type contains bindery object type. NCP_BINDERY_USER should be speciā
31 fied in most cases.
32
33 noOfReturnedConns
34 noOfReturnedConns contains number of returned connections. It may be
35 NULL, there is no reason for pass NULL into this function.
36
37 connList
38 connList is array for returned connection numbers. It may be NULL,
39 in this case, only noOfReturnedConns is returned.
40
41 maxConns
42 maxConns holds maximum number of returned connections. connList must
43 be NULL or large enough for maxConns * sizeof(NWCONN_NUM) bytes.
44
45
47 Function returns zero on success and non-zero on failure. If specified
48 object does not exist, success is returned and noOfReturnedConns is set
49 to zero.
50
51 See nwerrors(3ncp) for complete list of error codes.
52
53
54
56 None known.
57
58
60 nwerrors(3ncp), NWGetConnListFromObject(3ncp)
61
62
63
64libncp (>= 2.2.0.14) 04/13/1999NWGETOBJECTCONNECTIONNUMBERS(3NCP)