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.

-->	ioCompletion	ProcPtr	A pointer to the completion routine.
<--	ioResult	OSErr	The function result.
-->	csCode	Integer	Always killSendReq for this function.
-->	aKillQEl	Ptr	A 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

noErr	0	No error
cbNotFound	-1102	The 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.