Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_drop_prepared_statement() function drops a previously prepared statement.

mi_integer mi_drop_prepared_statement(stmt_desc)

MI_STATEMENT *stmt_desc;

stmt_desc

is a pointer to a statement descriptor that references a previously prepared statement.

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

The mi_drop_prepared_statement() is the destructor function for a statement descriptor. It frees the statement descriptor that stmt_desc references. The mi_prepare() function prepares a statement and returns a statement descriptor for the prepared statement. If a cursor is associated with the prepared statement, mi_drop_prepared_statement() also frees this cursor.

Tip: To free only the cursor associated with a prepared statement instead of the entire prepared statement, use the mi_close_statement() function.

Return Values

MI_OK	indicates that the function was successful.
MI_ERROR	indicates that the function was not successful.

See the description of the following functions: mi_close_statement(), mi_exec_prepared_statement(), mi_open_prepared_statement(), and mi_prepare().