Important: The information in this document is obsolete and should not be used for new development.
PRelTCB
ThePRelTCB
function cancels the pendingPSendRequest
function that you specify.
FUNCTION PRelTCB (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.
--> ioCompletion ProcPtr A pointer to a completion routine. <-- ioResult OSErr The function result. --> csCode Integer Always relTCB
for this function.--> addrBlock AddrBlock The destination socket address. --> transID Integer The transaction ID of the request
to be canceled.
Field Description
addrBlock
- The AppleTalk internet address of the destination socket for which the
PSendRequest
function that is to be canceled was meant.transID
- The transaction ID of the
PSendRequest
function to be canceled. You can get the transaction ID from thereqTID
field of thePSendRequest
parameter block queue entry.DESCRIPTION
ThePRelTCB
function releases the queued parameter block for thePSendRequest
function whose transaction ID you specify. ThePRelTCB
function returns a function result ofreqAborted
for the canceledPSendRequest
function.SPECIAL CONSIDERATIONS
You cannot use this function to cancel a send request that you made using thePNSendRequest
function.ASSEMBLY-LANGUAGE INFORMATION
To execute thePRelTCB
function from assembly language, call the_Control
trap macro with a value ofrelTCB
in thecsCode
field of the parameter block. To
execute this function from assembly language, you must also specify the .ATP
driver reference number.RESULT CODES
noErr 0 No error cbNotFound -1102 The ATP control block was not found noDataArea -1104 Too many outstanding ATP functions