INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_errmsg()

The mi_errmsg() function copies an error or warning message from the message descriptor into the specified buffer.

Syntax

Usage

The mi_errmsg() function is useful in a callback for getting the error or warning message associated with an exception. This function always terminates the message with a NULL value, provided buflen is greater than 0.

Message text that mi_errmsg() retrieves for server exceptions is the most-specific text, that is, the text associated with the Informix SQLCODE value. The mi_errmsg() function does not retrieve any ANSI or X/Open message text.

A client application adds error codes to the start of the message, but the database server does not.

For general information about server exceptions, see "Server Exceptions".

Return Values

None

Related Topics

For additional information, see the descriptions of the following functions: mi_error_desc_copy(), mi_error_desc_destroy(), mi_error_desc_is_copy(), mi_error_level(), mi_error_sql_state(), and mi_error_sqlcode().




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.