XHPSetErrorHandler(3X)XHPSetErrorHandler(3X)NAMEXHPSetErrorHandler - 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 ALSOXSetErrorHandler(3x)X Version 11 Release 5 XHPSetErrorHandler(3X)