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.