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 Informix® ESQL/C 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.