HP-UX C SIP Stack Message Layer Reference Guide (February 2008)

738 HP C SIP Stack Message Layer Reference Guide
Control Functions
RvSipSubscriptionStateHeaderParseValue()
RvSipSubscriptionStateHeaderParseValue()
DESCRIPTION
Parses a SIP textual Subscription-State header value into a Subscription-State
header. A SIP header has the following grammar: “header-name:header-value”.
This function takes the header-value part as a parameter and parses it into the
supplied object. All the textual parameters are placed inside the object.
Note Before performing the parse operation, the SIP Stack resets all the header
parameters. Therefore, if the parse function fails, you will not be able to get the
previous header parameter values.
Note Use the RvSipSubscriptionStateHeaderParse() function to parse strings
that also include the header-name.
SYNTAX
RvStatus RvSipSubscriptionStateHeaderParseValue(
IN RvSipSubscriptionStateHeaderHandle hHeader,
IN RvChar* buffer);
PARAMETERS
hHeader
The handle to the Subscription-State header.
buffer
The buffer containing a textual Subscription-State header value.
RETURN VALUES
Returns RvStatus.