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 21 - Providers Reference / Functions

Controlling a Provider's Modes of Operation /

OTSetSynchronous
Sets a provider to synchronous mode.

C INTERFACE
OSStatus OTSetSynchronous(ProviderRef ref);
C++ INTERFACE
OSStatus TProvider::SetSynchronous();
PARAMETERS

ref
The provider reference of the provider which you want to set to synchronous mode.
function result
An error code. See Appendix B for more information.

DISCUSSION
The OTSetSynchronous function causes all provider functions to run synchronously when using the provider that you specify. Changing this does not affect its notifier function, if any is installed for this provider; the notifier function remains installed.
You can call this function at any time and it will always succeed; however, you should take care changing this while outstanding asynchronous calls are in progress. See "Specifying How Provider Functions Execute" for more information.
To place a provider in asynchronous mode, call the OTSetAsynchronous function. To find out a provider's mode of execution, call the OTIsSynchronous function.

SEE ALSO
"Specifying How Provider Functions Execute".