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

Message Object Functions 33
Get and Set Functions
RvSipMsgGetHeaderByTypeExt()
RvSipMsgGetHeaderByTypeExt()
DESCRIPTION
Gets a header by type 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 cast the return value to the header type you requested. 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 RvSipMsgGetHeaderByType
function.
SYNTAX
void* RvSipMsgGetHeaderByTypeExt(
IN RvSipMsgHandle hSipMsg,
IN RvSipHeaderType eHeaderType,
IN RvSipHeadersLocation location,
IN RvSipMsgHeadersOption eOption,
INOUT RvSipHeaderListElemHandle* hListElem);
PARAMETERS
hSipMsg
The handle of the message.
eHeaderType
The header type to be retrieved.
location
The location on the list: next, previous, first or last.