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

606 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipReferToHeaderGetOtherParams()
RvSipReferToHeaderGetOtherParams()
DESCRIPTION
Copies the other-params parameter of the Refer-To header into a given buffer.
The generic parameters of the Refer-To header are referred to as “other-
params”. They are kept in the object in one concatenated string in the following
form: “name=value;name=value...”. If 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 RvSipReferToHeaderGetOtherParams(
IN RvSipReferToHeaderHandle hHeader,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hHeader
The handle to the Refer-To 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.
RETURN VALUES
Returns RvStatus.