PKillGetReq
PKillGetReq Kill a PGetRequest
#include <AppleTalk.h> AppleTalk Manager
OSErr PKillGetReq( thePBptr, async);
ATPPBPtr thePBptr; pointer to an ATPParamBlock structure
Boolean async; 0=await completion; 1=immediate return
returns Error Code; 0=no error
PKillGetReq aborts a PGetRequest
thePBptr is a pointer to an ATPParamBlock structure. The relevant fields are
as follows:
Out-InName Type Size Offset Description
Æ csCode short 2 26 Always PKillGetReq
Æ aKillQEl Ptr 1 44 Pointer to a queue element
async is a Boolean value. Use FALSE for normal ( synchronous) operation
or TRUE to enqueue the request and resume control immediately. See
Async I/O.
Returns: an operating system Error Code. It will be one of:
noErr (0) No error
cbNotFound (-1102) aKIllQEl does not point to a GetReq queue element

Notes: PKillGetReq will abort a specific outstanding PGetRequest call (as
opposed to closing the socket, which aborts all outstanding PGetRequest
calls on that socket). The call will be completed with a reqAborted error. To
abort a PGetRequest, place a pointer to the queue element of the call to
abort in aKillQEl and issue the PKillGetReq call.