mme_sync_get_status()

Gets information about system synchronization

Synopsis:

#include <mme/mme.h>

int mme_sync_get_status ( mme_hdl_t *hdl,
                          mme_sync_status_t *status,
                          size_t status_size )

Arguments:

hdl
An MME connection handle.
status
A pointer to an array of mme_sync_status_t structures where the function can store status information. Pass as NULL to get the number of mediastores actively involved in synchronization. See mme_sync_status_t in this reference.
status_size
The number of elements in the status array. It may be 0 (zero).

Library:

mme

Description:

The function mme_sync_get_status() gets information about system synchronization. You can call this function and pass status as NULL and status_size as 0 to simply return the number of mediastores that have synchronization passes underway or pending, and use this information to set up the status array for a subsequent call. However, keep in mind that mediastore synchronization status can change rapidly, so you should always check the return value for the number of elements that contain valid data in status.

Events

None delivered.

Blocking and validation

This function is non-blocking.

Returns:

0
Success. The value returned is the number of media stores that have synchronization passes in progress or pending.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_playlist_sync(), mme_sync_cancel(), mme_sync_get_msid_status() mme_sync_status_t()