The ifx_lo_stat_cspec() function

Syntax

ifx_lo_create_spec_t *ifx_lo_stat_cspec(LO_stat)
   ifx_lo_stat_t *LO_stat;

LO_stat

A pointer to an LO-status structure that ifx_lo_stat() allocates and completes with status information.

Usage

The ifx_lo_stat_cspec() function returns a pointer to an LO-specification structure, ifx_lo_create_spec_t, which contains the storage characteristics for the specified smart large object. You can use this LO-specification structure to create another smart large object with the same storage characteristics or to access the storage characteristics through the accessor (ifx_specget_) functions.

You must precede a call to ifx_lo_stat_cspec() with a call to ifx_lo_stat(). The ifx_lo_stat() function allocates the memory for the ifx_lo_create_spec_t structure, along with the ifx_lo_stat_t structure, and initializes it with the status information for the smart large object that you specified. When you call the ifx_lo_stat_free() function to free the ifx_lo_stat_t structure, it frees the ifx_lo_create_spec_t structure automatically.

Return codes

A valid pointer to an LO-specification (ifx_lo_create_spec_t) structure

The function was successful.

NULL

The function was not successful.