Home
Client APIs and toolsYou can use the HCL OneDB™ implementation of client APIs to develop applications for HCL OneDB™ database servers.
ESQL/C GuideThe HCL OneDB™ ESQL/C Programmer's Manual explains how to use , the HCL OneDB™ implementation of Embedded Structured Query Language (SQL) for C (ESQL/C), to create client applications with database-management capabilities.
AppendixesThis section contains additional reference information.
The ESQL/C function libraryThese topics describe the syntax and behavior of all the library functions provided with HCL® OneDB® ESQL/C.
The ifx_lo_stat_cspec() functionThe ifx_lo_stat_cspec() function returns the LO-specification structure for a smart large object.

The ifx_lo_stat_cspec() function

The ifx_lo_stat_cspec() function returns the LO-specification structure for a smart large object.

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.