hpux man page for xtappsetera

XtAppSetErrorHandler()													    XtAppSetErrorHandler()

Name
  XtAppSetErrorHandler - set the low-level error handler procedure.

Synopsis
  XtErrorHandler XtAppSetErrorHandler(app_context, handler)
	 XtAppContext app_context;
	 XtErrorHandler handler;

Inputs
  app_context
	    Specifies the application context.

  handler   Specifies the new fatal error procedure, which should not return.

Returns
  A pointer to the previously installed low-level error handler.

Description
  XtAppSetErrorHandler() registers the procedure handler in app_context as the procedure to be invoked by XtAppError().  It returns a pointer
  to the previously installed low-level fatal error handler.  handler must terminate the application; if it returns the  subsequent  behavior
  of the Intrinsics is undefined.

  The  default	low-level  error  handler  provided by the Intrinsics is _XtDefaultError().  On POSIX-based systems, it prints the message to
  standard error and terminates the application.

Usage
  Note that application-context-specific error handling is not implemented on many systems.  Most implementations will have just one  set  of
  error handlers.  If they are set for different application contexts, the one performed last will prevail.

See Also
  XtAppError(1), XtAppErrorMsg(1), XtAppSetErrorMsgHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHandler(1), XtAppWarning(1),
  XtAppWarningMsg(1),
  XtErrorHandler(2).

Xt - Error Handling													    XtAppSetErrorHandler()