The mi_lo_stat_ctime() function
The mi_lo_stat_ctime() function returns from an LO-status structure the last-change time for a smart large object.
Syntax
mi_integer mi_lo_stat_ctime(LO_stat)
MI_LO_STAT *LO_stat;- LO_stat
- 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_ctime() function
obtains the last-change time from the LO-status structure that LO_stat references.
The last-change time includes changes to metadata (modification of
storage characteristics, a change in the number of references) and
user data (writes to the smart large object). The resolution of the
last-change time that the mi_lo_stat_ctime() function
returns is number of seconds since 00:00:00, January 1, 1970.
Important: Before you call mi_lo_stat_ctime(),
you must initialize an LO-status structure with the mi_lo_stat() function.
For more information about the last-change time of a smart large object or about how to use an LO-status structure, see the HCL OneDB™ DataBlade® API Programmer's Guide.
Return values
- >=0
- The number of seconds since January 1, 1970 for the last-change time of the smart large object whose status information is in the LO-status structure that LO_stat references.
- MI_ERROR
- The function was not successful.