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

Message Object Functions 25
Get and Set Functions
RvSipMsgGetHeader()
RvSipMsgGetHeader()
DESCRIPTION
Gets a header from the header list. The message holds most headers in a
sequential list except, To, From, CallId, Cseq, ContentLength and Content-Type
headers. The 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.
Note The RvSipMsgGetHeaderExt() function is an extension of this function.
SYNTAX
void* RvSipMsgGetHeader(
IN RvSipMsgHandle hSipMsg,
IN RvSipHeadersLocation location,
INOUT RvSipHeaderListElemHandle* hListElem,
OUT RvSipHeaderType* pHeaderType);
PARAMETERS
hSipMsg
The handle to the message.
location
The location on 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.
pHeaderType
The type of the retrieved header.