CHAILink SDK  Version 1.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
CLC_ErrorCode Pipe_AddConnection ( CPHOBJECT const  hPipe,
CPENDPOINT const *const  pPeer 
)

Add a connection.

There is no effect if the connection is already set for the Pipe. Add a connection to the Pipe. The peer endpoint must point to another Pipe. Once the connection added from this side, an internal message is automatically sent to the peer in order to make it know this side and establish back communication. Both peers will be notified with other's description.

Parameters
[in]hPipePipe handle
[in]pPeerPointer to an endpoint. This endpoint MUST point to a Pipe.
Returns
Standard CHAILink Client return code. See CLC_ErrorCode enumeration.
Warning
This function can only be called in CopperLan context. This means in the pseudo task CPDoProcess(), in notification handlers or in asynchronous return handlers and not in SystemDoProcess() for instance.