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


PKillSendReq

The PKillSendReq function cancels the pending PSendRequest or PNSendRequest functions whose queue element pointer you specify.

FUNCTION PKillSendReq (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 killSendReq for this function.
-->aKillQElPtrA pointer to queue element of function
to be removed.

Field Description
aKillQEl
A pointer to the queue element of the pending function that is to be canceled. This is the pointer to the parameter block that you passed to the send request function when you issued the function.
DESCRIPTION
To cancel a specific pending PSendRequest or PNSendRequest function, you specify the pointer to the queue element for the function in the aKillQEl field of the parameter block for the PKillSendReq function, then call the function. If the function has
already completed execution or if it is not in the ATP queue for any other reason, PKillSendReq returns a message (cbNotFound) indicating that it could not find the parameter block.

ASSEMBLY-LANGUAGE INFORMATION
To execute the PKillSendReq function from assembly language, call the _Control trap macro with a value of killSendReq 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-1102The aKillQEl parameter does not point to a PSendRequest or PNSendRequest queue element
SEE ALSO
To send requests, use the PSendRequest function, described on page 6-24, and the PNSendRequest function, described on page 6-27.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996