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

334 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipContactHeaderGetOtherParams()
RvSipContactHeaderGetOtherParams()
DESCRIPTION
Copies the Contact header other-params parameter of the Contact header into a
given buffer. Not all the Contact header parameters have separated parameters in
the Contact 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...”. 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 RvSipContactHeaderGetOtherParams(
IN RvSipContactHeaderHandle hHeader,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hHeader
The handle to the Contact 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.