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

292 HP-UX C SIP Stack Programmers Guide
Persistent Connection Handling
RvSipCallLegSetConnection()
Sets a connection to call-legs or subscriptions. The call-leg or subscription will
set the connection to every client transaction it uses as long as the connection
fits the local and remote addresses of the request. when the connection no longer
fits, the call-leg or subscription will automatically detach from it.
Note To set the persistency level of a subscriptions, you must first get the
Subscription-associated call-leg and then use the Call-leg API. For more
information, see the Call-leg Functions chapter in the SIP Stack Reference Guide.
RvSipRegClientSetConnection()
Sets a connection to a register-client.
RvSipTransactionSetConnection()
Sets a connection to a transaction.
RvSipTransmitterSetConnection()
Sets a connection to a transmitter.
RVSIPXXXGETCONNECTION()
You can use this function to query a persistent object about the connection it is
using.
Note Non persistent TUs do not attach to their connection and therefore the
function will return NULL. The function will also return NULL for server
transactions.
The following API functions are supplied:
RvSipCallLegGetConnection()
Gets the connection currently used by a call-leg or a subscription.
RvSipRegClientGetConnection()
Gets the connection currently used by a register-client.