Get the name of the database being used in a specific synchronization.
#include <mmsync/mmsyncclient.h>
int mm_sync_status_get_dbname( mmsync_hdl_t *hdl,
uint32_t id,
char *dbname,
size_t dbname_sz,
uint32_t flags )
The mm-sync connection handle
The operation ID of the synchronization whose database's name is to be retrieved
A buffer to store the database name
The size of the dbname buffer
Must be 0; reserved for future use
Get the name of the database being used in the synchronization whose operation ID matches id. The database name is copied into the dbname buffer, with at most dbname_sz bytes being written. If there's no active synchronization with this operation ID (for example, if that synchronization has already finished), nothing is written to the buffer.
>=0 values indicate the number of results on success. When no synchronization with the specified ID is found, the return value is 0; this is not considered an error case. This function returns -1 on failure.