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

630 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipReferredByHeaderGetOtherParams()
RvSipReferredByHeaderGetOtherParams()
DESCRIPTION
Copies the Referred-By header other-params parameter of the Referred-By
header into a given buffer. Not all the Referred-By header parameters have
separated parameters in the Referred-By 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
list also includes the signature parameters. If the value of 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 RvSipReferredByHeaderGetOtherParams(
IN RvSipReferredByHeaderHandle hHeader,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hHeader
The handle to the Referred-By header.
strBuffer
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.