Counts the number of rows that need to be uploaded for synchronization.
ul_u_long ULCountUploadRows (
SQLCA * sqlca,
ul_u_long threshold );
sqlca A pointer to the SQLCA.
publication-mask A set of publications to check. A value of 0 indicates that the entire database needs to be checked. Otherwise, you need to supply a publication mask of OR'd publications. For example:
UL_PUB_PUB1 | UL_PUB_PUB2
threshold Determines the maximum number of rows to count, thereby limiting the amount of time taken by the call.
A threshold of 0 corresponds to no limit (that is, count all rows that need to be synchronized).
A threshold of 1 can be used to quickly determine if any rows need to be synchronized.
The number of rows that need to be synchronized, either in a set of publications or in the whole database.
Use this function to prompt users to synchronize.
The following call checks the entire database for the number of rows to be synchronized:
count = ULCountUploadRows( sqlca, 0, 0 );
The following call checks publications PUB1 and PUB2 for a maximum of 1000 rows:
count = ULCountUploadRows( sqlca, UL_PUB_PUB1 | UL_PUB_PUB2, 1000 );
The following call checks to see if any rows need to be synchronized:
count = ULCountUploadRows( sqlca, UL_SYNC_ALL, 1 );