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

Party Header Functions 545
Control Functions
RvSipPartyHeaderParse()
RvSipPartyHeaderParse()
DESCRIPTION
Parses a SIP textual Party header into a Party header. All the textual parameters
are placed inside the object. For example, “From:
<sip:[e-mail]>;tag=5”.
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.
SYNTAX
RvStatus RvSipPartyHeaderParse(
IN RvSipPartyHeaderHandle hHeader,
IN RvBool bIsTo,
IN RvChar* buffer);
PARAMETERS
hHeader
A 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.
RETURN VALUES
Returns RvStatus.
REMARKS
You must construct a Party header before using this function.