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

Authorization Header Functions 271
Get and Set Functions
RvSipAuthorizationHeaderGetCredentialIdentifier()
RvSipAuthorizationHeaderGetCredentialIdentifier()
DESCRIPTION
Gets the identifiers of the creditable Authentication header. This function will
return the realm and username strings without quotation marks (""). If you want
these parameters in quotation marks, use the specific Get functions, and not this
function. If the realmLen or usernameLen is adequate, the function copies the
strings into strRealm and strUsername buffers, Otherwise, the function returns
RV_ERROR_INSUFFICIENT_BUFFER and realmActualLen, and
usernameActualLen contain the required buffer length.
SYNTAX
RvStatus RvSipAuthorizationHeaderGetCredentialIdentifier(
IN RvSipAuthorizationHeaderHandle hHeader,
IN RvChar* strRealmBuff,
IN RvUint realmBuffLen,
IN RvChar* strUsernameBuff,
IN RvUint usernameBuffLen,
IN RvChar* strNonceBuff,
IN RvUint nonceBuffLen,
OUT RvUint* realmActualLen,
OUT RvUint* usernameActualLen,
OUT RvUint* nonceActualLen);
PARAMETERS
hHeader
The handle to the header.
strRealmBuff
The buffer with which to fill the requested parameter.
realmBuffLen
The length of the given realm buffer.