Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nwgetconnlistfromobject(3ncp) [debian man page]

NWGETCONNLISTFROMOBJECT(3NCP)											     NWGETCONNLISTFROMOBJECT(3NCP)

NAME

       NWGetConnListFromObject - Retrieve connection list of specified object

SYNOPSIS

       #include <nwcalls.h>

       NWCCODE NWGetConnListFromObject(NWCONN_HANDLE conn, nuint32 objID, NWCONN_NUM firstConn, size_t* noOfReturnedConns, NWCONN_NUM* connList);

DESCRIPTION

       This function retrieves connection list of specified object from server.

       conn
	  conn contains connection handle obtained from ncp_open(3ncp) or NWParsePath(3ncp).

       objID
	  objID contains server specific object ID. For bindery, it is object ID, for NDS objects it is local entry number.

       firstConn
	  firstConn specifies, from which connection start search. Use 0 on first call and highest returned value on subsequent.

       noOfReturnedConns
	  noOfReturnedConns contains number of returned connections. It may be NULL, there is no reason for pass NULL into this function.  At most
	  125 connections are returned at once.

       connList
	  connList is array for returned connection numbers. It may be NULL, in this case, only noOfReturnedConns  is  returned.   connList  array
	  must be able to hold 125 entries.

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.
       If noOfReturnedConns is 125, it is possible that list is incomplete and NWGetConnListFromObject should be invoked again for another set	of
       connections.

       See nwerrors(3ncp) for complete list of	error codes.

BUGS

       None known.

SEE ALSO

       nwerrors(3ncp), NWGetObjectConnectionNumbers(3ncp)

libncp (>;= 2.2.0.14)						    04/13/1999					     NWGETCONNLISTFROMOBJECT(3NCP)

Check Out this Related Man Page

NWGETOBJECTCONNECTIONNUMBERS(3NCP)										NWGETOBJECTCONNECTIONNUMBERS(3NCP)

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)

libncp (>;= 2.2.0.14)						    04/13/1999					NWGETOBJECTCONNECTIONNUMBERS(3NCP)
Man Page