Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

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
noErr0No error
memFullErr-108Not enough room in heap zone
errAENotASpecialFunction-1714Wrong keyword for a special handler

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996