Legacy Document

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

Inside Macintosh: PowerPC System Software /

Chapter 4 - Exception Manager / Exception Manager Reference

InstallExceptionHandler
You can use the InstallExceptionHandler function to install an exception handler.
extern ExceptionHandler InstallExceptionHandler 
                                 (ExceptionHandler theHandler);
theHandler
The address of the exception handler to be installed.

DESCRIPTION
The InstallExceptionHandler function installs the exception handler specified by the theHandler parameter. That handler replaces any existing exception handler associated with the current execution context. The newly installed handler remains active until you install some other handler or until you remove the current handler by calling InstallExceptionHandler with theHandler set to nil.

IMPORTANT
The theHandler parameter must be the address of a transition vector for the exception handler, not a universal procedure pointer.
The InstallExceptionHandler function returns the address of any existing exception handler as its function result. If there is no exception handler in place
for the current execution context, InstallExceptionHandler returns nil.

SPECIAL CONSIDERATIONS
The InstallExceptionHandler function is available to any code executing in the PowerPC native environment. You do not need to call it if your application or other software exists as 680x0 code and hence executes under the 68LC040 Emulator on PowerPC processor-based Macintosh computers.