The ITErrorManager class

Base class: ITObject

Manages error callbacks from the server or from the client library. Multiple callbacks can be set on an ITErrorManager instance. ITErrorManager defines functionality used by a number of subclasses for managing and dispatching errors for different operations, such as issuing queries and retrieving results. Using the ITErrorManager class, applications can set callback functions to be triggered by exceptional conditions generated during database access.

Events that might trigger the call to callback functions are:

Server exceptions-SQL errors, transaction state changes, warnings, and other exceptions.
DataBlade® API library exceptions.
C++ library events.

Callback functions must have the following signature:

typedef void      (*ITCallBackFuncPtr)
                  (const ITErrorManager &errorobject, 
                   void *userdata, 
                   long errorlevel);

The userdata parameter is for data passed to the callback function. The error-level parameter corresponds to the DataBlade API error level, and indicates whether the error is a message, an exception, or an unrecoverable error.

This class provides the following methods.


Method	Description
ITBool Error() const	Returns `TRUE` if either a server or client error occurs.
const ITString &SqlState() const	Returns the SQLSTATE code of an error. For details about SQLSTATE, see the Informix® Guide to SQL: Syntax.
const ITString &ErrorText() const	Returns error message text.
ITBool AddCallback(ITCallbackFuncPtr userfunc, void *userdata)	Adds a callback. For details, see Implementation notes.
ITBool DelCallback(ITCallbackFuncPtr userfunc, void *userdata)	Deletes a user-defined callback registered through AddCallback().
ITBool DispatchErrorText(const ITString &message)	Dispatches an error message with the specified message text.
ITBool Warn() const	Returns `TRUE` if a warning occurred.
const ITString & WarningText() const	Returns warning message text.