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

282 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipAuthorizationHeaderGetUserName()
RvSipAuthorizationHeaderGetUserName()
DESCRIPTION
Copies the user name string from the Authorization header into a given buffer. 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 RvSipAuthorizationHeaderGetUserName(
IN RvSipAuthorizationHeaderHandle hHeader,
IN RvChar* strBuffer,
IN RvUint bufferLen,
OUT RvUint* actualLen);
PARAMETERS
hHeader
The handle to the Authorization 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.