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_atime() functionThe ifx_lo_stat_atime() function returns the time of last access for a smart large object.

The ifx_lo_stat_atime() function

The ifx_lo_stat_atime() function returns the time of last access for a smart large object.

Syntax

mint ifx_lo_stat_atime(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 time of last access is only guaranteed to be maintained if the smart large object has the LO_KEEP_LASTACCESS_TIME flag set. If you do not set this flag, the database server does not write this access-time value to disk. The resolution of the time that the ifx_lo_stat_atime() function returns is seconds.

The status information for the smart large object is in the LO-status structure to which LO_stat points. The ifx_lo_stat() function allocates this structure and fills it with the status information for a particular smart large object. Therefore, you must precede a call to ifx_lo_stat_atime() with a call to ifx_lo_stat().

Return codes

>=0: The last-access time for the smart large object that LO_stat identifies.
-1: The function was not successful.