mm_sync_status_get_bydbname()

Get the status of a synchronization, based on the database name.

Synopsis:

#include <mmsync/mmsyncclient.h>
int mm_sync_status_get_bydbname( mmsync_hdl_t *hdl, 
                                 mmsync_status_t *status, 
                                 const char *dbname, 
                                 uint32_t flags )

Arguments:

hdl

The mm-sync connection handle

status

A status element to store the results in

dbname

The name of the database whose current synchronization status is to be retrieved

flags

Must be 0; reserved for future use

Library:

mmsyncclient

Description:

Get the status of a synchronization, based on the database name.

Returns:

>=0 values indicate the number of results on success. When no database with the given name is found, the return value is 0 because there are no results; this is not considered an error case. This function returns -1 on failure.