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

168 HP C SIP Stack Message Layer Reference Guide

Control Functions

RvSipAllowEventsHeaderParseValue()

DESCRIPTION

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

also include the header-name.

SYNTAX

RvStatus RvSipAllowEventsHeaderParseValue(

IN RvSipAllowEventsHeaderHandle hHeader,

IN RvChar* buffer);

PARAMETERS

hHeader

The handle to the Allow-Events header.

buffer

The buffer containing a textual Allow-Events header value.

RETURN VALUES

Returns RvStatus.