Legacy Document

Inside Macintosh: PowerPC System Software /

Chapter 4 - Exception Manager / Exception Manager Reference

Exception Manager Routines /

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.