geomonitor_create_region()

Create and initialize a geomonitor region instance.

Synopsis:

#include <geomonitor.h>

geomonitor_error_t geomonitor_create_region(geomonitor_region_t *region, const char *name)

Since:

BlackBerry 10.2.0

Arguments:

region: The created region.

name: A name for the region. This name should be unique and its length cannot exceed 200 characters.

Library:

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

Description:

This region is not monitored until it is added to the list of monitored regions by calling geomonitor_add().

region must be initialized to NULL before being passed to this function. You must call geomonitor_destroy_region() to properly release region.

Returns:

GEOMONITOR_OK upon success, an error from geomonitor_error_t otherwise.