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

546 HP C SIP Stack Message Layer Reference Guide
Control Functions
RvSipPartyHeaderParseValue()
RvSipPartyHeaderParseValue()
DESCRIPTION
Parses a SIP textual Party header value into an Party 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 RvSipPartyHeaderParse() function to parse strings that also
include the header-name.
SYNTAX
RvStatusRvSipPartyHeaderParseValue(
IN RvSipPartyHeaderHandle hHeader,
IN RvBool bIsTo,
IN RvChar* buffer);
PARAMETERS
hHeader
The handle to the Party header.
bIsTo
Indicates whether a header is a To header (RV_TRUE) or From header
(RV_FALSE).
buffer
The buffer containing a textual Party header value.