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

194 HP C SIP Stack Message Layer Reference Guide
Get and Set Functions
RvSipAuthenticationHeaderGetStringLength()
RvSipAuthenticationHeaderGetStringLength()
DESCRIPTION
Some of the Authentication header parameters are kept in a string format, for
example, the nonce parameter. In order to get such a parameter from the
Authentication header, your application should supply an adequate buffer to
where the string will be copied. This function provides you with the length of
the string to enable you to allocate an appropriate buffer size before calling the
Get function.
SYNTAX
RvUint RvSipAuthenticationHeaderGetStringLength(
IN RvSipAuthenticationHeaderHandle hHeader,
IN RvSipAuthenticationHeaderStringName eStringName);
PARAMETERS
hHeader
The handle to the Authentication header.
eStringName
The enumeration of the string name for which you require the length.
RETURN VALUES
Returns the length of specified string.