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

828 HP C SIP Stack Message Layer Reference Guide
Control Functions
RvSipHeaderParseValue()
RvSipHeaderParseValue()
DESCRIPTION
Parses a SIP textual header value, of any header type, into a 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 RvSipHeaderParse() function to parse strings that also include the
header-name.
SYNTAX
RvStatus RvSipHeaderParseValue(
IN void* hHeader,
IN RvSipHeaderType eType,
IN RvChar* buffer);
PARAMETERS
hHeader
The handle to the header.
eType
Type of the header to parse.
buffer
The buffer containing the textual header.
RETURN VALUES
Returns RvStatus.