geomonitor_region_set_monitoring_mode()

Set the region monitoring mode.

Synopsis:

#include <geomonitor.h>
 
geomonitor_error_t geomonitor_region_set_monitoring_mode(geomonitor_region_t region, geomonitor_monitoring_mode_t monitoring_mode)

Since:

BlackBerry 10.2.0

Arguments:

region

A handle to the geomonitor region.

monitoring_mode

The monitoring mode of the region.

Library:

libgeomonitor (For the qcc command, use the -l geomonitor option to link against this library)

Description:

A region in GEOMONITOR_MONITORING_MODE_TRANSIENT mode is only monitored while the application keeps at least one initialized geomonitor service handle. If an application closes all the geomonitor service handles, then the region will be removed. A region in GEOMONITOR_MONITORING_MODE_PERSISTENT mode will always be monitored until the region is explicitly removed by the originating application, or until the originating application is uninstalled, or until the region expires.

An application must have at least one open initialized geomonitor service handle to create a region in GEOMONITOR_MONITORING_MODE_TRANSIENT mode.

Returns:

GEOMONITOR_OK if successful, an error from geomonitor_error_t otherwise.

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus