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

mi_lo_stat_free()

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

Syntax

Usage

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

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

The function was successful.

MI_ERROR

The function was not successful. One of the arguments is invalid.

Related Topics

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

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



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