Legacy Document

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

Chapter 22 - Endpoints Reference / Functions

Tearing Down a Connection /

OTRcvOrderlyDisconnect

Clears an incoming orderly disconnect event.

C INTERFACE

OSStatus OTRcvOrderlyDisconnect(EndpointREf ref);

C++ INTERFACE

OSStatus TEndpoint::RcvOrderlyDisconnect();

PARAMETERS

ref

The endpoint reference of the endpoint acknowledging receipt of the disconnect request.

function result

An error code. See Appendix B.

DISCUSSION

You call the OTRcvOrderlyDisconnect function to acknowledge the receipt of an orderly disconnect event. After using the OTRcvOrderlyDisconnect function, there will not be any more data to receive. Attempts to receive data will fail with the kOTOutStateErr result. If the endpoint supports a remote orderly disconnect, you can still send data over the connection if you have not yet called the OTSndOrderlyDisconnect function.

The OTRcvOrderlyDisconnect function behaves in the same way in all modes of operation. If there is no disconnection request pending, the function returns with the kOTNoReleaseErr result. If there is a disconnection request pending, the function returns the kOTNoError result.

The OTRcvOrderlyDisconnect function is only supported by those protocols that have a servtype field of the TEndpointInfo structure with a value T_COTS_ORD or T_TRANS_ORD.

SEE ALSO

"Terminating a Connection".

Table 4-4.