geomonitor_service_initialize()

Create and initialize a geomonitor service handle and open a service connection.

Synopsis:

#include <geomonitor.h>
 
geomonitor_error_t geomonitor_service_initialize(geomonitor_service_t *geomonitor)

Since:

BlackBerry 10.2.0

Arguments:

geomonitor

The geomonitor_service_t handle to be created and initialized by this function. This parameter must be initialized to NULL when passed to this function.

Library:

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

Description:

The handle created and initialized by this function represents a service connection that you can use to receive geomonitor events.

The handle passed to the function must be initialized to NULL. The handle returned by the function has to be released by calling geomonitor_service_shutdown().

When you initialize the geomonitor service handle, 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