Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 3 - Errors, Warnings, and Notices / Errors, Warnings, and Notices Reference

Functions / Error Posting and Handling

GXGetUserGraphicsError

You can use the GXGetUserGraphicsError function to obtain the currently installed application-defined error handler.

gxUserErrorFunction GXGetUserGraphicsError(long *reference);

reference

A pointer to a long value that gets called each time an error occurs. This value can be used by the application for any purpose.

function result

A pointer to the installed application-defined error handler function.

DESCRIPTION

The GXGetUserGraphicsError function returns a pointer to the function that the application uses to handle errors. The function returns nil if no application-defined error handler is provided.

If an error-handling function is installed and the reference parameter is not nil, then the reference parameter passed to the GXSetUserGraphicsError function is returned.

SEE ALSO

The use of this function is described in the section "Installing an Error, Warning, or Notice Handler" beginning on page 3-38.

The GXSetUserGraphicsError function used to install the error handler is described in the previous section.

An alternative method to the use of an application-defined error handler is the use of the QuickDraw GX error set.

The GXGetGraphicsError function, described in the section "Obtaining Errors, Warnings, and Notices" beginning on page 3-30, returns the first and last QuickDraw GX errors that have been posted.