The mi_lo_stat_cspec() function

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

Syntax

MI_LO_SPEC *mi_lo_stat_cspec(LO_stat)
   MI_LO_STAT *LO_stat;
LO_stat
A pointer to an LO-status structure that mi_lo_stat() allocates and fills in with status information.
Valid in client LIBMI application? Valid in user-defined routine?
Yes Yes

Usage

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

You can use the LO-specification structure that mi_lo_stat_cspec() returns to create another smart large object with the same storage characteristics.

For more information about storage characteristics of a smart large object, about how to use an LO-status structure, or about how to use the mi_lo_stat_cspec() function, see the Informix® DataBlade® API Programmer's Guide.

Return values

An MI_LO_SPEC pointer
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
The function was not successful.