notification_request_events()

#include <bps/notification.h>
 

BPS_API int notification_request_events(int flags)

Since:

BlackBerry 10.0.0

Arguments:

flags

The types of events to deliver. A value of zero indicates that all events are requested. Non-zero values is reserved for future use.

Library:

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

Description:

The notification_request_events() function starts the delivery of notification events to your application using BPS.

If the application doesn't have permissions to listen to notifications, this function will fail. Events are posted to the currently active channel.

The varieties of events that may be returned are specified in the notification_response_t enumeration.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.