Home | Previous Page | Next Page   Function Descriptions >

mi_lo_stat_atime( )

The mi_lo_stat_atime( ) function returns from an LO-status structure the last-access time for a smart large object.

Syntax

mi_integer mi_lo_stat_atime(LO_stat)
   MI_LO_STAT *LO_stat;
LO_stat
is a pointer to an LO-status structure that mi_lo_stat( ) allocates and fills in with status information.
Valid in Client LIBMI Application? Valid in User-Defined Routine?
Yes Yes

Usage

The mi_lo_stat_atime( ) function obtains the current value for the last access time from the LO-status structure that LO_stat references. The resolution of the last-access time that mi_lo_stat_atime( ) returns is the number of seconds since 00:00:00, January 1, 1970.

Important:
Before you call mi_lo_stat_atime( ), you must initialize an LO-status structure with the mi_lo_stat( ) function.

Return Values

>=0
is the number of seconds since January 1, 1970, for the last-access time of the smart large object whose status information is in the LO-status structure that LO_stat references.
MI_ERROR
indicates that the function was not successful.

Related Topics

See also the descriptions of mi_lo_stat( ), mi_lo_stat_cspec( ), mi_lo_stat_ctime( ), mi_lo_stat_free( ), mi_lo_stat_mtime_sec( ), mi_lo_stat_mtime_usec( ), mi_lo_stat_refcnt( ), and mi_lo_stat_size( ).

For more information about the last-access time of a smart large object or on how to use an LO-status structure, see the IBM Informix: DataBlade API Programmer's Guide.

Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]