Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

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.

-->ioCompletionProcPtrA pointer to a completion routine.
<--ioResultOsErrThe function result.
-->ioCRefNumIntegerThe driver reference number.
-->csCodeIntegerAlways dspCLDeny for this function.
-->ccbRefNumIntegerThe CCB reference number.
-->remoteCIDIntegerThe ID of the remote connection end.
-->remoteAddressAddrBlockThe 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
noErr0No error
errState-1278Not a connection listener
errAborted-1279Request aborted by the dspRemove routine
errRefNum-1280Bad connection reference number

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996