Legacy Document

Inside Macintosh: Networking /

Chapter 5 - AppleTalk Data Stream Protocol (ADSP) / ADSP Reference

Routines / Establishing and Terminating an ADSP Connection Listener

dspCLRemove

The dspCLRemove routine closes a connection end used as a connection listener. You use the PBControl function to call the dspCLRemove routine. See "Routines" on page 5-43 for a description of the PBControl function.

-->	ioCompletion	ProcPtr	A pointer to a completion routine.
<--	ioResult	OSErr	The function result.
-->	ioCRefNum	Integer	The driver reference number.
-->	csCode	Integer	Always dspCLRemove for this function.
-->	ccbRefNum	Integer	The CCB reference number.
-->	abort	Byte	A value specifying to abort outstanding requests if not 0.

Field Description

csCode

The routine selector, always dspCLRemove for this routine.

ccbRefNum

The connection control block (CCB) reference number that the dspCLInit routine returned.

abort

A value directing ADSP whether or not to cancel any outstanding listen and deny requests. If this value is nonzero, ADSP cancels outstanding dspCLListen and dspCLDeny requests. If this value is 0, ADSP does not cancel these requests.

DESCRIPTION

The dspCLRemove routine closes a connection end used as a connection listener. After you call the dspCLRemove routine, you can release the memory that you allocated for the CCB if you do not intend to reopen the connection end.

ASSEMBLY-LANGUAGE INFORMATION

To execute the dspCLRemove routine from assembly language, call the _Control trap macro with a value of dspCLRemove in the csCode field of the parameter block.

RESULT CODES

noErr	0	No error
errRefNum	-1280	Bad connection reference number