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

238 HP C SIP Stack Message Layer Reference Guide
Control Functions
RvSipAuthenticationInfoHeaderParseValue()
RvSipAuthenticationInfoHeaderParseValue()
DESCRIPTION
Parses a SIP textual Authentication-Info header value into an Authentication-
Info 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 fields are placed inside the object.
Note Use the RvSipAuthenticationInfoHeaderParse() function to parse strings
that also include the header-name.
Note Before performing the parse operation the stack resets all the header fields.
Therefore, if the parse function fails, you will not be able to get the previous
header field values.
SYNTAX
RvStatus RvSipAuthenticationInfoHeaderParseValue(
IN RvSipAuthenticationInfoHeaderHandle hHeader,
IN RvChar* buffer);
PARAMETERS
hHeader
The handle to the Authentication-Info header.
buffer
The buffer containing a textual Authentication-Info header value.
RETURN VALUES
Returns RvStatus.