Contents Index ULEnableUserAuthentication function ULGetSynchResult function

UltraLite Embedded SQL User's Guide
  Embedded SQL Library Functions

ULGetLastDownloadTime function


Prototype 

ul_bool ULGetLastDownloadTime(
SQLCA * sqlca,
ul_publication_mask publication-mask,
DECL_DATETIME * value );

Description 

Obtains the last time a specified publication was downloaded.

Parameters 

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 Designing sets of data to synchronize separately.

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.

Returns 
Examples 

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 );
See also 

UL_SYNC_ALL macro

UL_SYNC_ALL_PUBS macro


Contents Index ULEnableUserAuthentication function ULGetSynchResult function