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

820 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipBodyPushBodyPart()
RvSipBodyPushBodyPart()
DESCRIPTION
Inserts a given body part into the body parts list based on a given location,
which can be first, last, before or after a given relative element. The body part
you supply is copied before it is inserted into the list. The function returns the
handle to the body part object that was actually inserted into the list. This body
part can be used in a following call to this function as the relative body part.
SYNTAX
RvStatus RvSipBodyPushBodyPart(
IN RvSipBodyHandle hBody,
IN RvSipListLocation location,
IN RvSipBodyPartHandle hBodyPart,
IN RvSipBodyPartHandle hRelative,
OUT RvSipBodyPartHandle *hNewBodyPart);
PARAMETERS
hBody
The handle of the body object.
location
The location in list, which can be next, previous, first or last.
hBodyPart
The handle to the body part to be pushed into the list.
hRelative
The handle to the current position in the list (a relative body part from the list).
Supply this value if you chose next or previous in the location parameter.
hNewBodyPart
The handle to a copy of hBodyPart that was inserted to the body parts list. Can
be used in further calls for this function as hRelative.