Legacy Document

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

Chapter 22 - Endpoints Reference / Functions

Tearing Down a Connection /

OTSndOrderlyDisconnect

Initiates an orderly disconnection.

C INTERFACE

OSStatus OTSndOrderlyDisconnect(EndpointRef ref);

C++ INTERFACE

OSStatus TEndpoint::SndOrderlyDisconnect();

PARAMETERS

ref

The endpoint reference of the endpoint initiating the orderly disconnect.

function result

An error code. See Appendix B.

DISCUSSION

You call the OTSndOrderlyDisconnect function to initiate an orderly disconnect of a connection and to indicate to the peer endpoint that you have no more data to send. After calling this function, you must not send any more data over the connection. However, you can still continue to receive data until the peer calls the OTSndOrderlyDisconnect function.

This function is a service that is not supported by all protocols. If it is supported, the servtype field of the TEndpointInfo structure has the value T_COTS_ORD or T_TRANS_ORD.

The OTSndOrderlyDisconnect function behaves exactly the same in all modes of operation.

SEE ALSO

The OTSndDisconnect function.

"Terminating a Connection".

Table 4-4.