Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_collection_free() function frees a collection.

mi_integer mi_collection_free(conn, coll_struc)

MI_CONNECTION *conn;

MI_COLLECTION *coll_struc;

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

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

The mi_collection_free() function frees the collection that the coll_struc collection structure references. This function is the destructor function for the collection structure.

See the descriptions of the following functions: mi_collection_close(), mi_collection_copy(), mi_collection_create(), mi_collection_delete(), mi_collection_fetch(), mi_collection_insert(), mi_collection_open(), and mi_collection_update().

For a description of collections, see Collections.