Important: The information in this document is obsolete and should not be used for new development.
ERdCancel
TheERdCancel
function cancels execution of a specific call to theERead
function.
FUNCTION ERdCancel (thePBptr: EParamBlkPtr; async: Boolean): OSErr;
thePBptr
- A pointer to a parameter block of type
EParamBlock
.async
- A Boolean value that specifies whether the function should be
executed asynchronously or synchronously. SpecifyTRUE
for asynchronous execution.
--> ioCompletion ProcPtr A pointer to completion routine. <-- ioResult OSErr The result code. --> ioRefNum Integer The driver reference number. --> csCode Integer Always ENetRdCancel
for this function.--> ePointer Ptr A pointer to ERead
parameter block.
Field Description
ePointer
- A pointer to the .ENET parameter block that you specified when you called the
ERead
function that you want to cancel.DESCRIPTION
To cancel anERead
function request using theERdCancel
function, you must have called theERead
function asynchronously. You specify in theePointer
parameter a pointer to the parameter block that you used when you called theERead
function.When you call the
ERdCancel
function, the pendingERead
function that you cancel receives thereqAborted
result code.TOKEN RING AND FDDI CONSIDERATIONS
This function is not valid for token ring and FDDI.ASSEMBLY-LANGUAGE INFORMATION
To execute theERdCancel
function from assembly language, call the_Control
trap macro with a value ofENetRdCancel
in thecsCode
field of the parameter
block. To execute the_Control
trap asynchronously, include the value,ASYNC
in
the operand field.RESULT CODES
noErr 0 No error cbNotFound -1102 ERead
not active