Start receiving navigator events.
#include <bps/navigator.h>
BPS_API int navigator_request_events(int flags)
BlackBerry 10.0.0
The types of events to deliver. A value of zero indicates that all regular events are requested. A value of NAVIGATOR_EXTENDED_DATA indicates all regular events are requested with extended data being available and navigator_raw_write() being able to send data.
The navigator_request_events() function starts to deliver navigator events to your application using BPS. Events will be posted to the currently active channel.
BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.