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

680 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipRouteHopHeaderGetOtherParams()
RvSipRouteHopHeaderGetOtherParams()
DESCRIPTION
Not all the Route-Hop header parameters have separated parameters in the
Route-Hop header. Parameters with no specific parameters are referred to as
“other-params”. They are kept in the object in one concatenated string in the
following form: “name=value;name=value...”. This function copies the Route-
Hop header other-params parameter of the Route-Hop header into a given
buffer. If the bufferLen is adequate, the function copies the requested parameter
into strBuffer. Otherwise, the function returns
RV_ERROR_INSUFFICIENT_BUFFER and actualLen contains the required
buffer length.
SYNTAX
RvStatus RvSipRouteHopHeaderGetOtherParams(
IN RvSipRouteHopHeaderHandle hHeader,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hHeader
The handle to the Route-Hop header.
strBuffer
The buffer to fill with the requested parameter.
bufferLen
The length of the buffer.
actualLen
The length of the requested parameter + 1 to include a NULL value at the end of
the parameter.