Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_close() function closes a connection.

mi_integer mi_close(conn)

MI_CONNECTION *conn;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() established.

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

The mi_close() function frees the connection descriptor that conn references. This function is the destructor function for a connection descriptor. After mi_close() is called, conn is no longer a valid open connection and all information associated with it becomes invalid. This information includes:

• Save sets created on the connection
• Callbacks registered for the connection
• Statement descriptors for the connection (both implicit and explicit)
• Cursors opened on the connection (with their associated rows)
• Function descriptors

It also deallocates the connection descriptor itself.

After a connection closes, any open LO file descriptors remain valid for the duration of the client session.

See the descriptions of the following functions: mi_open() and mi_server_connect().

For more information, see Closing a Connection.