Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 12 - Data Access Manager / Data Access Manager Reference

Data Access Manager Routines / Low-Level Interface: Controlling the Session

DBKill

Use the DBKill function to cancel the execution of an asynchronous routine.

FUNCTION DBKill (asyncPB: DBAsyncParmBlkPtr): OSErr;

asyncPB

A pointer to an asynchronous parameter block.

DESCRIPTION

The DBKill function cancels the execution of the asynchronous call specified by the asyncPB parameter.

SPECIAL CONSIDERATIONS

The DBKill function may move or purge memory. You should not call this routine from within an interrupt, such as in a completion routine or a VBL task.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the DBKill function are

Trap macro	Selector
_DBKill	$020E

RESULT CODES

noErr	0	No error
rcDBError	-802	Error canceling routine
rcDBBadAsynchPB	-810	Invalid parameter block specified
rcDBPackNotInited	-813	The InitDBPack function has not yet been called

SEE ALSO

For a description of the asynchronous parameter block, see page 12-56.