XESetError Extension Function

Purpose

Suppresses the call to an external error handling routine and defines an alternative routine for error handling.

Library

Enhanced X-Windows Library (libX11.a)

C Syntax

int (*XESetError(DisplayPtr, Extension, Procedure))()
Display *DisplayPtr;
int Extension;
int (*Procedure)();

Description

The XESetError extension function suppresses the call to an external error handling routine and defines an alternative routine for error handling. This extension function allows status to be returned on a call at the cost of the call being synchronous (though most such routines are query operations and are typically programmed to be synchronous).

When the Xlib library detects a protocol error in the _XReply extension function, it calls the procedure with the following:

int (*Procedure)(DisplayPtr, Error, Codes, ReturnCode);
Display *DisplayPtr;
xError *Error;
XExtCodes *Codes;
int *ReturnCode;

where:

• The Codes parameter is a pointer to the extension function codes structure.
• The Error parameter is a pointer to the 32-byte wire format error.
• The ReturnCode parameter is the return code returned by the _XReply extension function.

Parameters

Return Values

Related Information

Using Extensions in AIXwindows in AIX Version 4.3 AIXwindows Programming Guide.

The _XReply extension function.

AIXwindows Overview for Programmers in AIX Version 4.3 AIXwindows Programming Guide.