Legacy Document

Inside Macintosh: Networking /

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

Routines / Establishing and Terminating an ADSP Connection Listener

dspCLDeny

The dspCLDeny routine denies a connection request from a remote connection end. You use the PBControl function to call the dspCLDeny 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 dspCLDeny for this function.
-->	ccbRefNum	Integer	The CCB reference number.
-->	remoteCID	Integer	The ID of the remote connection end.
-->	remoteAddress	AddrBlock	The remote internet address.

.

Field Description

csCode

The routine selector, always dspCLDeny for this routine.

ccbRefNum

The CCB reference number for the connection listener that received the request. This is the CBB number that the dspCLInit routine returned for the connection listener when you established a connection listener.

remoteCID

The ID of the remote connection end. The dspCLListen routine returns this value.

remoteAddress

The internet address of the remote connection end. The dspCLListen routine returns this value.

DESCRIPTION

A connection server uses the dspCLDeny routine to inform a remote connection end that its request to open a connection cannot be honored. If you want your connection listener to continue to listen for further connection requests, you must call the dspCLListen request again after you call dspCLDeny.

ASSEMBLY-LANGUAGE INFORMATION

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

RESULT CODES

noErr	0	No error
errState	-1278	Not a connection listener
errAborted	-1279	Request aborted by the dspRemove routine
errRefNum	-1280	Bad connection reference number