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

190 HP C SIP Stack Message Layer Reference Guide

Control Functions

RvSipAuthenticationHeaderParseValue()

DESCRIPTION

Parses a SIP textual Authentication header value into an Authentication 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 RvSipAuthenticationHeaderParse() function to parse strings that

also include the header-name.

SYNTAX

RvStatus RvSipAuthenticationHeaderParseValue(

IN RvSipAuthenticationHeaderHandle hHeader,

IN RvChar* buffer);

PARAMETERS

hHeader

The handle to the Authentication header.

buffer

The buffer containing a textual Authentication header value.

RETURN VALUES

Returns RvStatus.