AERemoveSpecialHandler

Remove a handler from special handler table

#include <AppleEvents.h> Apple Event Manager

OSErr AERemoveSpecialHandler ( functionClass, handler,

isSysHandler );

AEKeyword functionClass ; keyword for special handler being gotten

ProcPtr handler ; pointer to special handler routine

Boolean isSysHandler ; TRUE = taken from system handler table

FALSE = taken from application handler table

returns Error Code; 0 = no error

The AERemoveSpecialHandler function removes a handler from a special

handler table.

The functionClass parameter is the keyword for the special handler to be

removed. There is currently only one value allowed for the functionClass

parameter: the keyPreDispatch constant, which identifies a handler routine

that is called immediately before the Apple Event Manager dispatches an

Apple event.

The handler parameter is a pointer to the special handler to be removed.

Although the functionClass parameter 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.

The isSysHandler parameter specifies the special handler table from which to

remove the handler. If its value is TRUE, the handler is taken from the system

handler table. If its value is FALSE, the handler is removed from the

application handler table.

Result codes

noErr (0) No error

memFullErr (-108) Not enough room in heap zone

errAENotASpecialFunction (-1714) Wrong keyword for a special

function

Referenced by (4):