SYNOPSIS
#include <nwcalls.h>NWCCODE NWGetObjectConnectionNumbers(NWCONN_HANDLE conn, const char* name, nuint16 type, size_t* noOfReturnedConns, NWCONN_NUM* connList, size_t maxConns);
DESCRIPTION
This function retrieves connection list of specified object from server.conn
- conn contains connection handle obtained from ncp_open(3ncp) or NWParsePath(3ncp).
name
- name contains bindery object name. Wildcards are not supported. Must not be NULL.
type
- type contains bindery object type. NCP_BINDERY_USER should be specified in most cases.
noOfReturnedConns
- noOfReturnedConns contains number of returned connections. It may be NULL, there is no reason for pass NULL into this function.
connList
- connList is array for returned connection numbers. It may be NULL, in this case, only noOfReturnedConns is returned.
maxConns
- maxConns holds maximum number of returned connections. connList must be NULL or large enough for maxConns * sizeof(NWCONN_NUM) bytes.
RETURN VALUE
Function returns zero on success and non-zero on failure. If specified object does not exist, success is returned and noOfReturnedConns is set to zero.See nwerrors(3ncp) for complete list of error codes.
BUGS
None known.