Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 4 - Responding to Apple Events / Reference to Responding to Apple Events

Routines for Responding to Apple Events / Creating and Managing the Coercion Handler Dispatch Tables

AERemoveCoercionHandler

You can use the AERemoveCoercionHandler function to remove a coercion handler from either the application or system coercion handler dispatch table.

FUNCTION AERemoveCoercionHandler (fromType: DescType; 
                                  toType: DescType; 
                                  handler: ProcPtr; 
                                  isSysHandler: Boolean): OSErr;

fromType

The descriptor type of the data coerced by the handler.

toType

The descriptor type of the resulting data.

handler

A pointer to the coercion handler. Although the fromType and toType parameters would be sufficient to identify the handler to be removed, providing the handler parameter is a safeguard to ensure that you remove the correct handler.

isSysHandler

The coercion table from which to remove the handler. If the value of this parameter is TRUE, the handler is removed from the system coercion table. If the value is FALSE, the handler is removed from the application coercion dispatch table.

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough room in heap zone
errAEHandlerNotFound	-1717	No coercion handler found