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

C INTERFACE
OSStatus OTAsyncOpenInternetServices (OTConfiguration *cfig,
                                          OTOpenFlags oflag,
                                          OTNotifyProcPtr proc,
                                         
C++ INTERFACE
None. C++ clients use the C interface to this function.

PARAMETERS

cfig
A pointer to a network configuration structure. You can obtain the default configuration by using the constant kDefaultInternetServicesPath for this parameter.
oflag
Reserved. Must be set to 0.
proc
A pointer to your notifier function. The TCP/IP service provider passes the internet services reference to your notifier function in the cookie parameter.
contextPtr
A pointer for your use. The TCP/IP service provider passes this value unchanged to your notifier function.
function result
A result code. See Appendix B for additional information.

DISCUSSION
You must open a TCP/IP service provider before calling any TCP/IP services functions other than the address utility functions. You must provide the Internet services reference when calling any of these non-utility functions. The OTAsyncOpenInternetServices function runs asynchronously and sets the mode of the TCP/IP service provider as asynchronous.
For information on how to specify options using the cfig parameter, see Table 11-2.

SEE ALSO
The OTOpenInternetServices function.