Important: The information in this document is obsolete and should not be used for new development.
PRelRspCB
ThePRelRspCB
function cancels aPSendResponse
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.
--> ioCompletion ProcPtr A pointer to the completion routine. <-- ioResult OSErr The function result. --> csCode Integer Always relRspCB
for this function.--> atpSocket Byte The number of the socket on which the request was received. --> addrBlock AddrBlock The internet socket address of the source
of the request.--> transID Byte The 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 thereqTID
field of thePSendResponse
parameter block queue entry.DESCRIPTION
ThePRelRspCB
function releases the queued parameter block for the exactly-once transactionPSendResponse
function without waiting for the release timer to expire
or for aTRel
packet to be received;PRelRspCB
returns a function result ofnoErr
for the canceledPSendResponse
call.If you call
PRelRspCB
to cancel a transaction that is not an exactly-once service,RelRspCB
returns a function result ofcbNotFound
for thePSendResponse
call.ASSEMBLY-LANGUAGE INFORMATION
To execute thePRelRspCB
function from assembly language, call the_Control
trap macro with a value ofrelRspCB
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 Control block not found; no pending asynchronous calls