UltraLite User's Guide
The Embedded SQL Interface
Library function reference
ul_bool ULGetLastDownloadTime(
SQLCA * sqlca,
ul_publication_mask publication-mask,
DECL_DATETIME * value );
Obtains the last time a specified publication was downloaded.
sqlca A pointer to the SQLCA.
publication-mask A set of publications for which the last download time is retrieved. A value of 0 corresponds to the entire database. The set is supplied as a mask. For example, the following mask corresponds to publications PUB1 and PUB2.:
UL_PUB_PUB1 | UL_PUB_PUB2
For more information on publication masks, see publication synchronization parameter.
value A pointer to the DECL_DATETIME structure to be populated.
A value of January 1, 1990 indicates that the publication has yet to be synchronized.
true Indicates that value is successfully populated by the last download time of the publication specified by publication-mask.
false Indicates that publication-mask specifies more than one publication or that the publication is undefined. If the return value is false, the contents of value are not meaningful.
The following call populates the dt structure with the date and time that publication UL_PUB_PUB1 was downloaded:
DECL_DATETIME dt; ret = ULGetLastDownloadTime( &sqlca, UL_PUB_PUB1, &dt );
The following call populates the dt structure with the date and time that the entire database was last downloaded. It uses the special UL_SYNC_ALL publication mask.
ret = ULGetLastDownloadTime( &sqlca, UL_SYNC_ALL, &dt );
publication synchronization parameter