informix
Informix DataBlade API Programmer's Manual
DataBlade API Function Descriptions

mi_lo_stat_mtime_sec()

The mi_lo_stat_mtime_sec() function returns from an LO-status structure the last modification time, in seconds, of a smart large object.

Syntax

Usage

The mi_lo_stat_mtime_sec() function is the LO-status accessor function that returns the last modification time from a set of status information. The last modification time includes changes to user data (writes to the smart large object) only. The resolution of the time that the mi_lo_stat_mtime_sec() function returns is number of seconds since January 1, 1970.

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

The mi_lo_stat_mtime_sec() function obtains the last modification time from the LO-status structure that LO_stat references.

Return Values

>=0 is the number of seconds since January 1, 1970 for the last modification 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 the descriptions of the following functions: mi_lo_stat(), mi_lo_stat_atime(), mi_lo_stat_cspec(), mi_lo_stat_ctime(), mi_lo_stat_free(), mi_lo_stat_refcnt(), and mi_lo_stat_size().

For more information about the last modification time of a smart large object, see Status Information. For more information on how to use the mi_lo_stat_mtime_sec() function, see The LO-Status Structure and Obtaining the Status of a Smart Large Object.


Informix DataBlade API Programmer's Manual, Version 9.2
Copyright © 1999, Informix Software, Inc. All rights reserved