XHPSetErrorHandler(3X) XHPSetErrorHandler(3X)
NAME
XHPSetErrorHandler - Register an X error handling routine.
SYNOPSIS
#include <X11/XHPlib.h>
typedef int (*PFI) ();
PFI XHPSetErrorHandler (display, routine)
Display *display;
int (*routine) ();
int routine (display, error)
Display *display;
XErrorEvent *error;
DESCRIPTION
This request registers with Xlib the address of a routine to handle X errors. It is intended to be used by libraries and drivers that wish
to establish an error handling routine without interfering with any error handling routine that may have been established by the client
program.
XHPSetErrorHandler records one error handling routine per connection to the server. Therefore, in order for a library or driver to set up
its own error handling routine without affecting that of the client, the library or driver must first have established its own connection
to the server via XOpenDisplay.
When an XErrorEvent is received by the client, which error handling routine is invoked is determined by the display associated with the
error. If the display matches that associated with a driver error handling routine, that error handling routine will be invoked. If it
does not match any driver routine, the error handling routine established by the client, if any exists, will be invoked. Otherwise, the
default Xlib error handler will be invoked.
XHPSetErrorHandler returns the address of the previously established error handler. If that error handler was the default error handler,
NULL is returned.
A driver or library may remove its error handler by invoking XHPSetErrorHandler with a NULL error handling routine.
FILES
/usr/include/X11/XHPlib.h
ORIGIN
Hewlett-Packard Company
SEE ALSO
XSetErrorHandler(3x)
X Version 11 Release 5 XHPSetErrorHandler(3X)