Legacy Document

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

Chapter 21 - Providers Reference / Functions

Controlling a Provider's Modes of Operation /

OTSetBlocking

Sets a provider to wait or block until it can complete a function.

C INTERFACE

OSStatus OTSetBlocking(ProviderRef ref);

C++ INTERFACE

OSStatus TProvider::SetBlocking();

PARAMETERS

ref

The provider reference of the provider that is to block.

function result

An error code. See Appendix B for more information.

DISCUSSION

For a full description of the effect of this call, see "Setting a Provider's Blocking Status".

If a provider is in blocking mode and you call the OTCloseProvider function to close the provider, Open Transport gives each STREAMS module up to 15 seconds to process outgoing data.

To set a provider's blocking mode to nonblocking, call the OTSetNonBlocking function. To find out a provider's current blocking mode, call the OTIsNonBlocking function.