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

OTInetAddressToName
Determines the canonical name of the host associated with an IP address.

C INTERFACE
OSStatus OTInetAddressToName (InetSvcRef ref,
                                         InetHost addr,
                                         InetDomainName nfo);
C++ INTERFACE
TInternetServices::AddressToName (InetHost addr,
                                         InetDomainName name);
PARAMETERS

ref
The internet services reference you obtained when you opened the TCP/IP service provider.
addr
The IP address for which you want to determine the associated domain name.
name
A character array that you must allocate. On output, the function places the canonical name in this array.
function result
A result code. See Appendix B for more information.

DISCUSSION
If you call this function asynchronously, the TCP/IP service provider calls your notifier function with the T_DNRADDRTONAMECOMPLETE completion event code when the function completes. The cookie parameter to the notifier function contains the name parameter to this call. If you had more than one simultaneous outstanding call to the OTInetAddressToName function, you can use this information to determine which call has completed execution.

SEE ALSO
The OTInetStringToAddress function.
The OTInetStringToHost function.