Legacy Document

Inside Macintosh: Networking /

Chapter 6 - AppleTalk Transaction Protocol (ATP) / ATP Reference

Routines / Opening and Closing an ATP Socket

PCloseATPSkt

The PCloseATPSkt function closes a socket that was opened to receive ATP requests or to send requests over a specific socket.

FUNCTION PCloseATPSkt (thePBPtr: ATPPBPtr; async: Boolean): OSErr;

thePBPtr

A pointer to an ATP parameter block.

async

A Boolean that indicates whether the function should be executed asynchronously or synchronously. Specify TRUE for asynchronous execution.

-->	ioCompletion	ProcPtr	A pointer to a completion routine.
<--	ioResult	OSErr	The function result.
-->	csCode	Integer	Always closeATPSkt for this function.
-->	atpSocket	Byte	The socket number.

Field Description

atpSocket

The number of the socket to be closed.

DESCRIPTION

The PCloseATPSkt function closes the socket that you opened to receive ATP requests or to send them over a specific socket.

ASSEMBLY-LANGUAGE INFORMATION

To execute the PCloseATPSkt function from assembly language, call the _Control trap macro with a value of closeATPSkt in the csCode field of the parameter block. To execute this function from assembly language, you must also specify the .ATP driver reference number.

RESULT CODES

noErr	0	No error
noDataArea	-1104	Too many outstanding ATP calls