|
Obtains the last time a specified publication was downloaded.
ul_bool ULGetLastDownloadTime (
SQLCA * sqlca,
ul_publication_mask publication-mask,
DECL_DATETIME * value );
sqlca A pointer to the SQLCA.
publication-mask A set of publications for which the last download time is retrieved. A value of 0 indicates that all publications in the database requires a download timestamp. The set is supplied as a mask. For example, the following mask corresponds to publications PUB1 and PUB2.:
UL_PUB_PUB1 | UL_PUB_PUB2
value A pointer to the DECL_DATETIME structure to be populated. For example, value of January 1, 1990 indicates that the publication has yet to be synchronized.
true The value is successfully populated by the last download time of the publication that was specified by publication-mask.
false The publication-mask specifies more than one publication or that the publication is undefined. 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 );