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

Message Object Functions 29
Get and Set Functions
RvSipMsgGetHeaderByName()
RvSipMsgGetHeaderByName()
DESCRIPTION
Gets a header by name from the header list. The message holds most headers in
a sequential list except, To, From, CallId, Cseq, ContentLength and Content-
Type headers. This function should be used only for headers of type
RVSIP_HEADERTYPE_OTHER.
Note The RvSipMsgGetHeaderByNameExt() function is an extension of this
function.
SYNTAX
RvSipOtherHeaderHandle RvSipMsgGetHeaderByName(
IN RvSipMsgHandle hSipMsg,
IN RvChar* strName,
IN RvSipHeadersLocation location,
INOUT RvSipHeaderListElemHandle* hListElem);
PARAMETERS
hSipMsg
The handle to the message.
strName
The header name to be retrieved.
location
The location in the header list: next, previous, first or last.
hListElem
The handle to the current position in the list. Supply this value if you chose next
or previous in the location parameter. This is also an output parameter and will
be set with a link to requested header in the list.