Contents Index ULEnableUserAuthentication function ULGetSynchResult function pdf/preface.pdf

UltraLite User's Guide
  The Embedded SQL Interface
    Library function reference

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 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.

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 

publication synchronization parameter

UL_SYNC_ALL macro

UL_SYNC_ALL_PUBS macro


Contents Index ULEnableUserAuthentication function ULGetSynchResult function pdf/preface.pdf