Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_lo_stat_free() function frees an LO-status structure.

mi_integer mi_lo_stat_free(conn, LO_stat)

MI_CONNECTION *conn;

MI_LO_STAT *LO_stat;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
LO_stat	is a pointer to an LO-status structure that mi_lo_stat() allocates and fills in with status information.

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

The mi_lo_stat_free() function frees the LO-status structure that LO_stat references. This function is the destructor for the LO-status structure.

Important: Do not use system memory-allocation calls (such as free() or mi_free()) to perform memory management for LO-status structures.

When your application no longer needs status information, call mi_lo_stat_free() for each LO-status structure that the mi_lo_stat() function has allocated. Once freed, these resources can be reallocated to other structures

Warning: Do not call the mi_lo_stat_free() function for the same LO-status structure more than once. This behavior is analogous to the behavior of the free() system function for regular memory allocation.

Return Values

MI_OK	indicates that the function was successful.
MI_ERROR	indicates that the function was not successful. One of the arguments is invalid.

See the descriptions of the following functions: mi_lo_stat(), mi_lo_stat_atime(), mi_lo_stat_cspec(), mi_lo_stat_ctime(), mi_lo_stat_mtime_sec(), mi_lo_stat_refcnt(), and mi_lo_stat_size().

For more information, see Freeing an LO-Status Structure.