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 6 - AppleTalk Transaction Protocol (ATP) / ATP Reference
Routines / Canceling Pending ATP Functions


PRelRspCB

The PRelRspCB function cancels a PSendResponse function that is an exactly-once transaction.

FUNCTION PRelRspCB (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.
-->ioCompletionProcPtrA pointer to the completion routine.
<--ioResultOSErrThe function result.
-->csCodeIntegerAlways relRspCB for this function.
-->atpSocketByteThe number of the socket on which the request was received.
-->addrBlockAddrBlockThe internet socket address of the source
of the request.
-->transIDByteThe transaction ID of the request with which the PSendResponse function to
be canceled is associated.

Field Description
atpSocket
The number of the socket on which the request was received and from which the PSendResponse function that is to be canceled was sent.
addrBlock
The internet socket address of the application that issued
the request.
transID
The transaction ID of the PSendResponse call to be canceled.
You can get the transaction ID from the reqTID field of the PSendResponse parameter block queue entry.
DESCRIPTION
The PRelRspCB function releases the queued parameter block for the exactly-once transaction PSendResponse function without waiting for the release timer to expire
or for a TRel packet to be received; PRelRspCB returns a function result of noErr
for the canceled PSendResponse call.

If you call PRelRspCB to cancel a transaction that is not an exactly-once service, RelRspCB returns a function result of cbNotFound for the PSendResponse call.

ASSEMBLY-LANGUAGE INFORMATION
To execute the PRelRspCB function from assembly language, call the _Control trap macro with a value of relRspCB 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
noErr0No error
cbNotFound-1102Control block not found; no pending asynchronous calls

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996