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

Retry-After Header Functions 659
Get and Set Functions
RvSipRetryAfterHeaderGetRetryAfterParams()
RvSipRetryAfterHeaderGetRetryAfterParams()
DESCRIPTION
Copies the retry-after-params parameter of the Retry-After header into a given
buffer. Not all the Retry-After header parameters have separated parameters in
the Retry-After header. Parameters with no specific parameters are referred to as
RetryAfterParams. They are kept in the object in one concatenated string in the
following form: “name=value;name=value...”.
If the value of 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 RvSipRetryAfterHeaderGetRetryAfterParams(
IN RvSipRetryAfterHeaderHandle hHeader,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hHeader
The handle to the Retry-After header.
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.