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

Chapter 30 - AppleTalk Reference / AppleTalk Service Provider Reference

AppleTalk Service Functions /

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.