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

318 HP C SIP Stack Message Layer Reference Guide
Control Functions
RvSipContactHeaderParseValue()
RvSipContactHeaderParseValue()
DESCRIPTION
Parses a SIP textual Contact header value into an Contact 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 RvSipContactHeaderParse() function to parse strings that also
include the header-name.
SYNTAX
RvStatus RvSipContactHeaderParseValue(
IN RvSipContactHeaderHandle hHeader,
IN RvChar* buffer);
PARAMETERS
hHeader
The handle to the Contact header.
buffer
The buffer containing a textual Contact header value.
RETURN VALUES
Returns RvStatus.