NWGETOBJECTCONNECTIONNUMBERS

NAME

NWGetObjectConnectionNumbers - Retrieve connection list of specified object

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.