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

Address Functions 111
SIP URL: Get and Set Functions
RvSipAddrUrlGetStrUserParam()
RvSipAddrUrlGetStrUserParam()
DESCRIPTION
Copies the user param string from the URL address into a given buffer. Use this
function if RvSipAddrUrlGetUserParam() returns
RVSIP_USERPARAM_OTHER. If the bufferLen is adequate, the function
copies the parameter into the strBuffer. Otherwise, the function returns
RV_ERROR_INSUFFICIENT_BUFFER and the actualLen parameter contains
the required buffer length.
SYNTAX
RvStatus RvSipAddrUrlGetStrUserParam(
IN RvSipAddressHandle hSipAddr,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hSipAddr
The handle to the URL address.
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.
RETURN VALUES
Returns RvStatus.