hpux man page for xtappgetera

XtAppGetErrorDatabase() 												   XtAppGetErrorDatabase()

Name
  XtAppGetErrorDatabase - obtain the default error database.

Synopsis
  XrmDatabase *XtAppGetErrorDatabase(app_context)
	 XtAppContext app_context;

Inputs
  app_context
	    Specifies the application context.

Returns
  The address of an XrmDatabase.

Description
  XtAppGetErrorDatabase() returns the address of the XrmDatabase error message database used by the default high-level error and warning han-
  dlers for app_context.  This database may be empty until XtAppGetErrorDatabaseText() is called for the first time.

  While the X Toolkit specification permits individual error databases for each application context, most implementations will only support a
  single database.  In the MIT implementation, the error database file is /usr/lib/X11/XtErrorDB.

Usage
  You should never need to call this function if you simply want to report error and warning messages through the standard handlers.

  Because the Intrinsics do not support the customization and internationalization of error messages very well, some applications may want to
  override values in the default database with their own customized messages.  The default database can be obtained for this purpose by  mak-
  ing a single dummy call to XtAppGetErrorDatabaseText() and then calling XtAppGetErrorDatabase().

See Also
  XtAppErrorMsg(1), XtAppGetErrorDatabaseText(1), XtAppWarningMsg(1),
  XtErrorMsgHandler(2).

Xt - Error Handling													   XtAppGetErrorDatabase()