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)