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

92 HP C SIP Stack Message Layer Reference Guide
SIP URL: Get and Set Functions
RvSipAddrUrlGetHost()
RvSipAddrUrlGetHost()
DESCRIPTION
Copies the host parameter from the address into a given buffer. If the bufferLen
is adequate, the function copies the parameter into the strBuffer. Otherwise, the
function returns RV_ERROR_INSUFFICIENT_BUFFER and actualLen
contains the required buffer length.
SYNTAX
RvStatus RvSipAddrUrlGetHost(
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 given buffer.
actualLen
The length of the requested parameter + 1, to include NULL character at the end
of the string.
RETURN VALUES
Returns RvStatus.