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

Route-Hop Header Functions 685

Get and Set Functions

RvSipRouteHopHeaderGetRpoolString()

DESCRIPTION

Copy a string parameter from the Route-Hop header into a given page from a

specified pool. The copied string is not consecutive.

SYNTAX

RvStatus RvSipRouteHopHeaderGetRpoolString(

IN RvSipRouteHopHeaderHandle hSipRouteHopHeader,

IN RvSipRouteHopHeaderStringName eStringName,

INOUT RPOOL_Ptr *pRpoolPtr);

PARAMETERS

hSipRouteHopHeader

The handle to the Route-Hop header.

eStringName

The string the user wishes to get.

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 set the returned offset to UNDEFINED, this

means that the parameter was not set to the Route-Hop header.

RETURN VALUES

Returns RvStatus.