Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 4 - QuickDraw GX Debugging / QuickDraw GX Debugging Reference

Functions / Setting and Getting Validation Options and Errors

GXGetValidationError

You can use the GXGetValidationError function to determine the application function and parameter that caused the last validation error.

void GXGetValidationError(char *procedureName, void **argument,
                           long *argumentNumber);

procedureName

A pointer to the name of the function that produced the validation error.

argument

A pointer to a list of the function's arguments.

argumentNumber

A pointer to the number of the argument that produced the validation error.

DESCRIPTION

The GXGetValidationError function provides the name of the function, a list of the function's parameters, and the number of the parameter that produced the last validation error. The argumentNumber parameter for the nth parameter is n. For example, the argumentNumber for the third parameter is 3. If you call the GXGetValidationError function and no validation errors have been posted, the function returns nil.

This function leaves its arguments unchanged in the non-debugging version of QuickDraw GX.

SEE ALSO

The use of the GXGetValidationError function is described in the section "Analyzing the Cause of Validation Errors" beginning on page 4-21.