dialog_request_events()

Start receiving dialog events.

Synopsis:

#include <bps/dialog.h>
 
BPS_API int dialog_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 dialog_request_events() function starts to deliver dialog events to your application using BPS. Dialog events are sent when a dialog button is pressed. Your application must call this function before calling any other dialog functions. Events are posted to the currently active channel.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.