Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_error_desc_copy() function returns a copy of a specified error descriptor.

MI_ERROR_DESC *mi_error_desc_copy(src_err_desc)

MI_ERROR_DESC *src_err_desc;

src_err_desc

is a pointer to the error descriptor to copy.

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

The mi_error_desc_copy() function is the constructor function for the error descriptor. It creates a copy of the src_err_desc error descriptor.

The mi_error_desc_copy() function allocates a new error descriptor in the current memory duration.

Important: Be sure to destroy the MI_ERROR_DESC structure with mi_error_desc_destroy() when your DataBlade API code no longer needs it.

Return Values

MI_ERROR_DESC *	is a pointer to the newly allocated copy of the error descriptor that src_err_desc references.
NULL	indicates that the function was not successful.

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

For a general discussion of how to copy error descriptors, see Creating a Copy of an Error Descriptor.