geomonitor_add()

Add a region to the list of monitored regions.

Synopsis:

#include <geomonitor.h>
 
geomonitor_error_t geomonitor_add(geomonitor_region_t region)

Since:

BlackBerry 10.2.0

Arguments:

region

The region to add to the list of monitored regions.

Library:

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

Description:

The region is stored and monitored until:
  • it is explicitly removed by the originate application,
  • the originating application is uninstalled,
  • the region expires, or
  • the originating application is running and has at least one initialized geomonitor service handle (in case region monitoring mode is set to GEOMONITOR_MONITORING_MODE_TRANSIENT).

The region is monitored from the time it is added to the list.

When you add a region to the list of monitored regions, this function makes a service request and blocks until the service responds.

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