HP-UX C SIP Stack Programmer's Guide (Novembery 2007)

Working with DNS 337
Manipulating the DNS List Object
MANIPULATING THE
DNS L
IST OBJECT
After calling the RvSipTransactionDnsContinue() function, the application
receives a handle to the new cloned transaction. By calling the
RvSipTransactionDNSGetList() function, the application can get the handle to
the DNS List object (RvSipTransportDNSListHandle) and manipulate the list.
By manipulating the DNS list, the application can:
 Add records taken from internal source, rather than retrieved
from an external DNS server.
 Remove unwanted records.
DNS LIST API The DNS List API is part of the Transport API. In order to use the API, you
need the following handles:
 TransportMgr handle (received from the
RvSipStackGetTransportMgrHandle() function).
 DNS List object handle (received from the
RvSipTransactionDNSGetList() function).
The following API functions are available:
RvSipTransportDNSGetEnumResult()
Gets the result of an ENUM NAPTR query.
RvSipTransportDNSListGetIPElement()
Gets an IP element from the list.
RvSipTransportDNSListRemoveTopmostIPElement()
Removes the top-most IP element.
RvSipTransportDNSListPopIPElement()
Pops the top-most IP element.
RvSipTransportDNSListPushIPElement()
Pushes an IP element to the list.
RvSipTransportGetNumberOfDNSListEntries()
Gets the number of elements in each sublist of the DNS List object.
SRV
AND HOST
R
ECORDS FUNCTIONS
Similar functions apply to SRV and Host records: