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

Message Object Functions 59
Get and Set Functions
RvSipMsgGetRpoolString()
RvSipMsgGetRpoolString()
DESCRIPTION
Copies a string parameter from the message into a given page from a specified
pool. The copied string is not consecutive.
SYNTAX
RvStatus RvSipMsgGetRpoolString(
IN RvSipMsgHandle hSipMsg,
IN RvSipMessageStringName eStringName,
INOUT RPOOL_Ptr *pRpoolPtr);
PARAMETERS
hSipMsg
The handle to the message.
eStringName
The string that the user wishes to get. In the current version,
RVSIP_MSG_CALL_ID is the only supported string.
pRpoolPtr
A pointer to a location inside an RPOOL. You need to supply only the pool and
page. The offset where the returned string was located will be returned as an
output parameter. If the function sets the returned offset to UNDEFINED, this
means that the parameter was not set to the Other header.
RETURN VALUES
Returns RvStatus.