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

238 HP-UX C SIP Stack Programmer’s Guide
Subscription API
RvSipSubsInitStr()
After creating a subscription, you can use this function to set the To, From and
Event headers value in a string format, and the Expires header value in the
subscription. If the subscription was created within an existing call-leg, you
should not set the To and From parameters.
RvSipSubsDialogInit()
After creating a subscription, you can use this function to set the To, From,
Local and Remote Contact parameters of the subscription’s dialog. This
function is relevant for an independent subscription (with no call-leg).
RvSipSubsDialogInitStr()
After creating a subscription, you can use this function to set the To, From,
Local and Remote Contact parameters of the subscription’s dialog in string
format. This function is relevant for an independent subscription (with no call-
leg).
RvSipSubsSubscribe()
After creating and initializing a subscription, you can use RvSipSubsSubscribe()
for generating and sending the required SUBSCRIBE message to establish the
subscription.
RvSipSubsRefresh()
After the subscription was established successfully, it assumes the
SUBS_ACTIVE state. In this state the subscriber may refresh the timer of the
subscription by sending another SUBSCRIBE request on the same dialog as the
existing subscription. For this purpose use RvSipSubsRefresh(). It generates and
sends a refresh SUBSCRIBE message with a new Expires header, and updates
the Subscription state machine to progress to the SUBS_REFRESHING state.
RvSipSubsUnsubscribe()
After the subscription was established successfully, it assumes the
SUBS_ACTIVE state. In every state from now on, the subscriber may ask the
notifier to terminate the subscription by sending another SUBSCRIBE request
on the same dialog as the existing subscription with the Expires header equal to
0. (Such a subscribe request is called “unsubscribe”). For this purpose use