Inside Macintosh: Open Transport /

Chapter 2 - Providers / Providers Reference

Functions / Controlling a Provider's Mode of Operation

OTCancelSynchronousCalls

Cancels any currently executing synchronous function for a specified provider.

C INTERFACE

OSStatus OTCancelSynchronousCalls(ProviderRef ref);

C++ INTERFACE

void TProvider::CancelSynchronousCalls(OSStatus err);

PARAMETERS

ref

The provider reference for the provider whose synchronous function you want to cancel.

DESCRIPTION

The OTCancelSynchronousCalls function cancels any currently executing synchronous function for the provider that you specify. The provider need not be in synchronous mode when you call this function.

Typically, you would call the OTCancelSynchronousCalls function at interrupt time by installing a Time Manager task that executes after a given amount of time has passed. You could do this to prevent a synchronous function from hanging the system.

IMPORTANT

The OTCancelSynchronousCalls function may cause a provider to be unusable. Typically, once this call is made, the only thing you can do with the provider is close it. For example, calling the OTCancelSynchronousCalls function on a connection-oriented endpoint might break its connection and render the endpoint unusable.

SEE ALSO

To set a provider to synchronous mode, call the OTSetSynchronous function (page 2-28). To find out a provider's current mode of execution, call the OTIsSynchronous function (page 2-30).

Time Manager tasks are described in the Time Manager chapter of Inside Macintosh: Processes.