Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_error_desc_next() function gets the next error descriptor from the list of current exceptions that are associated with the current SQL statement.

MI_ERROR_DESC *mi_error_desc_next(err_desc)

MI_ERROR_DESC *err_desc;

err_desc

is a pointer to the current error descriptor in the list of current exceptions. The mi_error_desc_next() function returns the error descriptor that follows this err_desc descriptor.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
No	Yes

The mi_error_desc_next() returns the next error descriptor from the exception list of which err_desc is part. The exception list contains the error descriptors for situations that generate multiple exceptions. Normally, an exception callback is called once for each exception. However, if a situation generates multiple exceptions, you probably do not want the callback to be invoked for each exception. The callback can use the mi_error_desc_next() function to obtain the details of an exception and to prevent the callback from being called again for that exception.

See the descriptions of the following functions: mi_errmsg(), mi_error_desc_copy(), mi_error_desc_destroy(), mi_error_desc_is_copy(), mi_error_desc_finish(), mi_error_level(), mi_error_sql_state(), and mi_error_sqlcode().