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

196 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipAuthenticationHeaderGetStrAuthScheme()
RvSipAuthenticationHeaderGetStrAuthScheme()
DESCRIPTION
Copies the authentication scheme string value from the authentication object
into a given buffer. Use this function if
RvSipAuthenticationHeaderGetAuthScheme() returns
RVSIP_AUTH_SCHEME_OTHER. 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 RvSipAuthenticationHeaderGetStrAuthScheme(
IN RvSipAuthenticationHeaderHandle hHeader,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hHeader
The handle to the Authentication header.
strBuffer
The buffer with which to fill 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.