Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Networking With Open Transport / Part 2 - Open Transport Reference

Chapter 29 - TCP/IP Services Reference / Functions

OTInitDNSAddress
Fills in a DNSAddress structure with your data.

C INTERFACE
size_t OTInitDNSAddress (DNSAddress *addr,
                     char *str);
C++ INTERFACE
None. C++ clients use the C interface to this function.

PARAMETERS

addr
A pointer to a DNSAddress structure that you allocate. The function fills in the fAddressType field of the DNSAddress structure with the value AF_DNS and fills in the structure's fName field with the address string you specify.
str
A pointer to a domain name string.
function result
The function returns the size of the resulting DNSAddress structure as an unsigned integer.

DISCUSSION
You can use the DNSAddress structure to provide an address when you use a UDP or TCP endpoint. If you do so, the domain name resolver resolves the address for you automatically.

SPECIAL CONSIDERATIONS
The OTInetDNSAddress function cannot block and always runs synchronously. It does not use the services of the DNR.