geomonitor_service_wait_event()

Start listening for geomonitor notifications.

Synopsis:

#include <geomonitor.h>

geomonitor_error_t geomonitor_service_wait_event(geomonitor_service_event_t *event)

Since:

BlackBerry 10.2.0

Arguments:

event: A pointer to the geomonitor event. This parameter must be initialized to NULL.

Library:

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

Description:

The caller assumes ownership of event and must release it by calling geomonitor_service_destroy_event().

This function blocks the calling thread until a geomonitor event occurs.

Returns:

GEOMONITOR_OK if successful, an error from geomonitor_error_t otherwise. GEOMONITOR_LOCATION_SERVICES_DISABLED is returned if location services are turned off.