Carbon


AERemoveCoercionHandler

Header: AEDataModel.h Carbon status: Supported

Removes a coercion handler from a coercion handler dispatch table.

OSErr AERemoveCoercionHandler (
    DescType fromType, 
    DescType toType, 
    AECoercionHandlerUPP handler, 
    Boolean isSysHandler
);
fromType

The descriptor type of the data coerced by the handler. For a list of AppleScript’s predefined descriptor types, see “Descriptor Type Constants”.

toType

The descriptor type of the resulting data. For a list of AppleScript’s predefined descriptor types, see “Descriptor Type Constants”.

handler

A universal procedure pointer to the coercion handler to remove. Although the parameters fromType and toType are sufficient to identify the handler, you can identify the handler explicitly as a safeguard. If you pass NULL for this parameter, the Apple Event Manager relies solely on the event class and event ID to identify the handler.

isSysHandler

Specifies the coercion table to remove the handler from. Pass TRUE to remove the handler from the system coercion table or FALSE to remove the handler from your application’s coercion table. Use of the system coercion table is not recommended for Carbon applications.

function result

A result code.

VERSION NOTES

Use of system coercion tables is not recommended for Carbon applications—see “Coercion Handlers” (to be supplied later) for more information.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)