Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_lo_spec_free() function frees an LO-specification structure.

mi_integer mi_lo_spec_free(conn, LO_spec)

MI_CONNECTION *conn;

MI_LO_SPEC *LO_spec;

conn	is a pointer to the connection descriptor a that previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() has established.
LO_spec	is a pointer to the LO-specification structure to free.

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

The mi_lo_spec_free() function is the destructor for the LO-specification structure. It frees the LO-specification structure that LO_spec references.

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

When your application no longer needs an LO-specification structure, call mi_lo_spec_free() to free the resources of the LO-specification structure that the mi_lo_spec_init() function has allocated. Once freed, these resources can be reallocated to other structures.

Warning: Do not call the mi_lo_spec_free() function for the same LO-specification 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.

See the descriptions of the following functions: mi_lo_open(), mi_lo_spec_init(), mi_lo_specget_estbytes(), mi_lo_specget_extsz(), mi_lo_specget_flags(), mi_lo_specget_maxbytes(), mi_lo_specget_sbspace(), mi_lo_specset_estbytes(), mi_lo_specset_extsz(), mi_lo_specset_flags(), mi_lo_specset_maxbytes(), and mi_lo_specset_sbspace().

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