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 30 - AppleTalk Reference / AppleTalk Service Provider Reference

OTOpenAppleTalkServices
Opens a synchronous AppleTalk service provider.

C INTERFACE
ATSvcRef OTOpenAppleTalkServices(OTConfiguration* cfig, 
                                         OTOpenFlags flags, 
                                         OSStatus* 
C++ INTERFACE
None. C++ clients use the C interface to this function.

PARAMETERS

cfig
A pointer to a configuration structure that specifies the AppleTalk service provider's characteristics. You can obtain this pointer by using the constant kDefaultAppleTalkServicesPath for this parameter. This directs Open Transport to create an AppleTalk service provider on the default hardware port, which is the one selected in the AppleTalk control panel.
flags
Reserved. Set to 0.
err
A pointer to a variable of type OSStatus that holds the result code for this function. A value of 0 (kOTNoErr) indicates successful completion.
function result
See Discussion.

DISCUSSION
The OTOpenAppleTalkServices function opens an AppleTalk service provider and gives you a unique AppleTalk service provider reference for it. This function also sets the mode of all the AppleTalk service provider to synchronous.

SPECIAL CONSIDERATIONS
When you no longer need to use AppleTalk service provider functions, you must call the generic Open Transport function OTCloseProvider.

SEE ALSO
The OTAsyncOpenAppleTalkServices function.