geolocation_request

Request a status update.

Synopsis:

#include <bps/geolocation.h>

BPS_API int geolocation_request_status(void)

Since:

BlackBerry 10.2.0

Arguments:

Library:

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

Description:

The geolocation_request_status() function requests a status notification to be delivered to the application using BPS. If the application does not have the read_geolocation capability, this function will fail. Events are posted to the currently active channel. You must call geolocation_request_events() to receive status events.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.