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

Message Object Functions 35
Get and Set Functions
RvSipMsgGetHeaderByNameExt()
RvSipMsgGetHeaderByNameExt()
DESCRIPTION
Gets a header by name from the header list. The message holds most headers in
a sequential list except for the To, From, CallId, Cseq, ContentLength and
Content-Type headers. This function should be used only for headers of the
RVSIP_HEADERTYPE_OTHER type. The header list can hold both valid
syntax and bad-syntax headers. Using the eOption parameter, you should
specify whether you wish to get any type of header or only headers with valid
syntax.
Note This function extends the functionality of RvSipMsgGetHeaderByName
function.
STANDS
RvSipOtherHeaderHandle RvSipMsgGetHeaderByNameExt(
IN RvSipMsgHandle hSipMsg,
IN RvChar* strName,
IN RvSipHeadersLocation location,
IN RvSipMsgHeadersOption eOption,
INOUT RvSipHeaderListElemHandle* hListElem);
PARAMETERS
hSipMsg
The handle of the message.
strName
The header name to be retrieved.
location
The location on the list: next, previous, first or last.