The mi_lo_spec_free() function
The mi_lo_spec_free() function frees an LO-specification structure.
Syntax
mi_integer mi_lo_spec_free(conn, LO_spec)
MI_CONNECTION *conn;
MI_LO_SPEC *LO_spec;- conn
- This value is one of the following connection values:
A pointer to a connection descriptor established by a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect().
A NULL-valued pointer (database server only)
- LO_spec
- A pointer to the LO-specification structure to free.
| Valid in client LIBMI application? | Valid in user-defined routine? |
|---|---|
| Yes | Yes |
Usage
The mi_lo_spec_free() function
is the destructor for the LO-specification structure. It frees the
LO-specification structure that LO_spec references.
Restriction: 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.
Restriction: 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.
Server only: The mi_lo_spec_free() function
does not need a connection descriptor to execute. If your UDR does
not need a valid connection for other operations, you can specify
a NULL-valued pointer for the conn parameter to establish a
NULL connection. For information about the advantages of a NULL connection,
see the Informix®
DataBlade® API Programmer's Guide.
Return values
- MI_OK
- The function was successful.
- MI_ERROR
- The function was not successful.