informix
Informix DataBlade API Programmer's Manual
DataBlade API Function Descriptions

mi_lo_stat_cspec()

The mi_lo_stat_cspec() function returns from an LO-status structure the storage characteristics for a smart large object.

Syntax

Usage

The mi_lo_stat_cspec() function is the LO-status accessor function that returns the storage characteristics from a set of status information. To access storage characteristics from this structure, use the LO-specification accessor functions.

Important: Before you call mi_lo_stat_cspec(), you must initialize an LO-status structure with the mi_lo_stat() function.

The mi_lo_stat_cspec() function returns a pointer to an LO-specification structure that contains the storage characteristics from the LO-status structure that LO_stat references. You can use this LO-specification structure to create another smart large object with the same storage characteristics.

Return Values

MI_LO_SPEC * is a pointer to the LO-specification structure that contains the storage characteristics for the smart large object whose status information is in the LO-status structure that LO_stat references.
NULL indicates that the function was not successful.

Related Topics

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

For more information on storage characteristics of a smart large object, see Storage Characteristics and Status Information. For more information on how to use the mi_lo_stat_cspec() function, see The LO-Status Structure, Obtaining the Status of a Smart Large Object, and Storage Characteristics from an Existing Smart Large Object.


Informix DataBlade API Programmer's Manual, Version 9.2
Copyright © 1999, Informix Software, Inc. All rights reserved