NWGetObjectConnectionNumbers.3ncp

Langue: en

Version: 45077 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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.

SEE ALSO

nwerrors(3ncp), NWGetConnListFromObject(3ncp)