INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_lo_spec_free()

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

Syntax

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.

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

The function was successful.

MI_ERROR

The function was not successful.

Related Topics

 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().

In Chapter 3, "Handling Smart Large Objects," see "Deallocating an LO-Specification Structure".



DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.