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

Message Object Functions 31
Get and Set Functions
RvSipMsgGetHeaderExt()
RvSipMsgGetHeaderExt()
DESCRIPTION
Gets a header 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 returns the handle to the requested header
as a void pointer.
You should check the pHeaderType parameter and cast the return value to the
appropriate header handle. 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 the RvSipMsgGetHeader()
function.
SYNTAX
void* RvSipMsgGetHeaderExt(
IN RvSipMsgHandle hSipMsg,
IN RvSipHeadersLocation location,
IN RvSipMsgHeadersOption eOption,
INOUT RvSipHeaderListElemHandle* hListElem,
OUT RvSipHeaderType* pHeaderType);
PARAMETERS
hSipMsg
The handle of the message.
location
The location on list: next, previous, first or last.
eOption
Specifies whether the application wishes to get only legal syntax headers or any
header (legal and illegal headers).