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

142 HP C SIP Stack Message Layer Reference Guide
TEL URI: Get and Set Functions
RvSipAddrTelUriGetOtherParams()
RvSipAddrTelUriGetOtherParams()
DESCRIPTION
Copies the URL other-params parameter of the address into a given buffer. Not
all the address parameters have separated parameters in the address. Parameters
with no specific parameters are referred to as “other-params”. They are kept in
the object in one concatenated string in the 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 RvSipAddrTelUriGetOtherParams(
IN RvSipAddressHandle hSipAddr,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hSipAddr
The handle to the TEL URI address.
strBuffer
The buffer to fill with the requested parameter.
bufferLen
The length of the given buffer.
actualLen
The length of the requested parameter + 1, to include a NULL character at the
end of the string.
RETURN VALUES
Returns RvStatus.