Important: The information in this document is obsolete and should not be used for new development.
dspCLDeny
ThedspCLDeny
routine denies a connection request from a remote connection end. You use thePBControl
function to call thedspCLDeny
routine. See "Routines" on page 5-43 for a description of thePBControl
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 thedspCLDeny
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 thedspCLListen
request again after you calldspCLDeny
.ASSEMBLY-LANGUAGE INFORMATION
To execute thedspCLDeny
routine from assembly language, call the_Control
trap macro with a value ofdspCLDeny
in thecsCode
field of the parameter block.RESULT CODES
noErr 0 No error errState -1278 Not a connection listener errAborted -1279 Request aborted by the dspRemove
routineerrRefNum -1280 Bad connection reference number