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() functionThe ifx_lo_stat() function returns information about the status of an open smart large object.

The ifx_lo_stat() function

The ifx_lo_stat() function returns information about the status of an open smart large object.

Syntax

mint ifx_lo_stat(LO_fd, LO_stat)
   mint LO_fd;
   ifx_lo_stat_t **LO_stat;

LO_fd: The LO-file descriptor for the open smart large object whose status information you want to obtain.
LO_stat: A pointer that points to a pointer to an LO-status structure that ifx_lo_stat() allocates and completes with status information.

Usage

The ifx_lo_stat() function allocates an LO-status structure, ifx_lo_stat_t, and initializes it with the status information for the smart large object that the LO_fd file descriptor identifies. To access the status information, use the accessor functions for the LO-status structure. For more information about the status information and the corresponding accessor functions, see Status information in the LO-status structure.

Use the ifx_lo_stat_free() function to deallocate an LO-status structure.

Return codes

0: The function was successful.
<0: The function was not successful and the return value indicates the cause of the failure.