led_request_events()

Start receiving LED status change events.

Synopsis:

#include <bps/led.h>

BPS_API int led_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. The meaning of 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 led_request_events() function starts to deliver LED status change events to your application using BPS. If the application does not have the access_led_control capability, this function will fail. Events will be posted to the currently active channel.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.