HP-UX C SIP Stack Programmer's Guide (Novembery 2007)

Working with the Transport Layer 293
Working with Connections
RvSipTransactionGetConnection()
Gets a connection currently used by a transaction.
RvSipTransmitterGetConnection()
Gets a connection currently used by a transmitter.
RVSIPXXXNEWCONNINUSEEV()
This callback function notifies the application that the object is now using a new
connection. The connection can be a totally new connection or a suitable
connection that was found in the hash.
WORKING WITH
C
ONNECTIONS
The Transport layer API provides the means to establish, maintain, and release
transport connections. The Transport API relates to the following entities:
 Connection (connection)
 Transport Manager (TransportMgr)
CONNECTIONS Connections are used to reliably deliver data between two user agents using
TCP or TLS transport. A SIP Stack connection is identified by its Local address,
Remote address and Transport protocol (TCP or TLS). Your application can
create and initialize connections, connect and disconnect connections, and apply
connections for the use of specific SIP Stack objects. All application
connections are inserted into the connection hash upon initialization. A
connection is a stateful object which can assume any state from a set defined in
the Transport API. A connection state represents the state of the connection
establishment between two SIP User Agents.
TRANSPORT MANAGER The TransportMgr manages the collection of connections. The TransportMgr is
mainly used for creating new connections.
WORKING WITH
HANDLES
All connections and the TransportMgr are identified using handles. You must
supply these handles when using the Transport API:
RvSipTransportMgrHandle
Defines the TransportMgr handle. You receive this handle by calling
RvSipStackGetTransportMgrHandle().