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

Route-Hop Header Functions 667
Control Functions
RvSipRouteHopHeaderConstructInMsg()
RvSipRouteHopHeaderConstructInMsg()
DESCRIPTION
Constructs a Route-Hop header inside a given message. The header is kept in
the header list of the message. You can choose to insert the header either at the
head or tail of the list. Use RvSipRouteHopHeaderSetHeaderType() to
determine whether the object represents a Route, Record-Route, Path or
Service-Route header.
SYNTAX
RvStatus RvSipRouteHopHeaderConstructInMsg(
IN RvSipMsgHandle hSipMsg,
IN RvBool pushHeaderAtHead,
OUT RvSipRouteHopHeaderHandle* hHeader);
PARAMETERS
hSipMsg
The handle to the message.
pushHeaderAtHead
A Boolean value indicating whether the header should be pushed to the head of
the list (RV_TRUE) or to the tail (RV_FALSE).
hHeader
The handle to the newly constructed Route header.
RETURN VALUES
Returns RvStatus.