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

106 HP C SIP Stack Message Layer Reference Guide
SIP URL: Get and Set Functions
RvSipAddrUrlGetStrTransport()
RvSipAddrUrlGetStrTransport()
DESCRIPTION
Copies the transport protocol string from the URL address into a given buffer.
Use this function if RvSipAddrUrlGetTransport() returns
RVSIP_TRANSPORT_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 RvSipAddrUrlGetStrTransport(
IN RvSipAddressHandle hSipAddr,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hSipAddr
The handle to the URL address.
strBuffer
Buffer to include the requested parameter.
bufferLen
The length of the given buffer.
actualLen
The length of the requested parameter + 1, to include NULL character at the end
of the string.
RETURN VALUES
Returns RvStatus.