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

GXGetGraphicsError

You can use the GXGetGraphicsError function to obtain the first and last QuickDraw GX errors posted.

gxGraphicsError GXGetGraphicsError(gxGraphicsError *stickyError);

stickyError

On return, a pointer to the first error posted.

function result

The last error posted.

DESCRIPTION

The GXGetGraphicsError function returns the last error posted, or 0 if no error has been posted. This function clears the last error so that all calls to this function return 0 until an error is posted.

The stickyError parameter, if not nil, is a pointer to the first error posted since the last call to the GXGetGraphicsError function. QuickDraw GX clears the stickyError parameter at the end of every call to the GXGetGraphicsError function.

SEE ALSO

The use of this function is described in the section "Obtaining Errors, Warnings, and Notices" beginning on page 3-30. Non-debugging errors that may be posted are listed in the section "Errors" beginning on page 3-6. Debugging errors that may be posted are listed in the section "Errors" beginning on page 3-6.

An alternative method of posting errors is to include an application-defined error handler. This topic is described in the section "Installing an Error, Warning, or Notice Handler" beginning on page 3-38.

The GXSetUserGraphicsError function is used to install the error handler and is described on page 3-56.