ATPReqCancel

Dequeue a call

#include <AppleTalk.h> AppleTalk Manager

OSErr ATPReqCancel( abRecord, async);

ATATPRecHandle abRecord; handle to an ATATPRec

Boolean async; 0=await completion; 1=immediate return

returns Error Code; 0=no error

ATPReqCancel is part of the AppleTalk alternate interface. It is

recommended that you use the preferred call, PRelTCB instead.

abRecord is a handle to an ATATPRec structure

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) ATP Control Block not found

Notes: Given the handle to the ATATPRec of a previously made ATPSndRequest

or ATPRequest call, ATPReqCancel de queues the calls, provided they

have not been completed. This routine returns noErr if the call is

successfully removed from the queue. If it returns cbNotFound, check the

abResult field of abRecord to verify that the call has completed and

determine its outcome.

Referenced by (5):