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

80 HP C SIP Stack Message Layer Reference Guide
Control Functions
RvSipAddrEncode()
RvSipAddrEncode()
DESCRIPTION
Encodes an address to a textual address. The textual header is placed on a page
taken from a specified pool. To copy the textual header from the page to a
consecutive buffer, use RPOOL_CopyToExternal().
SYNTAX
RvStatus RvSipAddrEncode(
IN RvSipAddressHandle hSipAddr,
IN HRPOOL hPool,
OUT HPAGE* hPage,
OUT RvUint32* length);
PARAMETERS
hSipAddr
The handle to the address.
hPool
The handle to the specified memory pool.
hPage
The memory page allocated to contain the encoded object.
length
The length of the encoded information.
RETURN VALUES
Returns RvStatus.
REMARKS
Your application must free the allocated page, using RPOOL_FreePage(). The
allocated page must be freed only if this function returns RV_OK.