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

Message Object Functions 39
Get and Set Functions
RvSipMsgPushHeader()
RvSipMsgPushHeader()
DESCRIPTION
Inserts a given header into the header list based on a given location. For
example, first, last, before or after a given element. The message holds most
headers in a sequential list except, To, From, CallId, Cseq, ContentLength and
Content-Type headers.
The header you supply is copied before it is inserted into the list. The
pNewHeader output parameter contains the handle to the actual header pushed
into the list. You should use this handle to refer to the header pushed into the list.
SYNTAX
RvStatus RvSipMsgPushHeader(
IN RvSipMsgHandle hSipMsg,
IN RvSipHeadersLocation location,
IN void* pHeader,
IN RvSipHeaderType eHeaderType,
INOUT RvSipHeaderListElemHandle* hListElem,
OUT void** pNewHeader);
PARAMETERS
hSipMsg
The handle to the message.
location
The location in the header list: next, previous, first or last.
pHeader
The handle to the header pushed into the list.
eHeaderType
Type of the header to be pushed.