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

68 HP-UX C SIP Stack Programmer’s Guide
Call-leg re-INVITE
RvSipCallLegReInviteRequest()
Begins a re-INVITE procedure that alters the session media description and
settings. You can call this function only after the call-leg received a 2xx final
response for its initial INVITE request, and when there are no other re-INVITE
pending processes. You can use the outbound message mechanism to set
headers and a body to the outgoing re-INVITE.
Remarks: This function does not handle the call-leg Session-Timer parameters.
Thus, when used during a Session Timer call, it turns off the Session Timer
mechanism. Consequently, in order to keep the mechanism up, use the
RvSipCallLegSessionTimerInviteRefresh() function instead.
RvSipCallLegReInviteAck()
When the SIP Stack is configured to work in a manual ACK mode, the call-leg
will not send an ACK message after receiving a 2xx response to a re-INVITE.
After receiving the 2xx response, the re-INVITE object will assume the
MODIFY_REINVITE_REMOTE_ACCEPTED state. The application must use
the RvSipCallLegReInviteAck() function to trigger the re-INVITE object to
send the ACK.
RvSipCallLegReInviteTerminate()
Causes a re-INVITE object to be terminated without sending any messages
(CANCEL or BYE). The re-INVITE will assume the TERMINATED modify
state.
RvSipCallLegReInviteSetAppHandle()
Sets an application handle to the re-INVITE object.
Note Other re-INVITE functionality, such as accepting, rejecting, cancelling,
and sending a provisional response for a re-INVITE is done with the basic Call-
leg API functions.
RE-INVITE EVENTS The following event is supplied for a call-leg re-INVITE object:
RvSipCallLegReInviteStateChangedEv()
Through this function you receive notifications of the modify state change of the
re-INVITE object.