bps_push_event()

Post an event to the active channel.

Synopsis:

#include <bps/bps.h>

BPS_API int bps_push_event(bps_event_t *event)

Since:

BlackBerry 10.0.0

Arguments:

event: The event to post to the active channel.

Library:

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

Description:

The bps_push_event() function allows an application to post to the application's active channel's event queue. You can use the bps_event_create() function to create a custom event in your application, and then use the bps_push_event() function to add the event to the active event queue.

Use the bps_channel_push_event() function to post the event when a channel is not active at the time or is owned by a different thread.

Returns:

BPS_SUCCESS when the function completes successfully, BPS_FAILURE with errno value set otherwise.