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 Special Handler Dispatch Tables

AEGetSpecialHandler

You can use the AEGetSpecialHandler function to get a specified special handler.

FUNCTION AEGetSpecialHandler (functionClass: AEKeyword; 
                              VAR handler: ProcPtr; 
                              isSysHandler: Boolean): OSErr;

functionClass

The keyword for the special handler that is installed. The keyPreDispatch constant identifies a handler with the same parameters as an Apple event handler that is called immediately before the Apple Event Manager dispatches an Apple event. Any of the constants for object callback functions listed on page 4-100 can also be specified in this parameter.

handler

A pointer to the special handler.

isSysHandler

Specifies the special handler dispatch table from which to get the handler. If the value of this parameter is TRUE, the handler is taken from the system special handler dispatch table. If the value is FALSE, the handler is taken from the application's special handler dispatch table.

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough room in heap zone
errAENotASpecialFunction	-1714	Wrong keyword for a special handler