Post an event to the active channel.
BPS_API int bps_push_event(bps_event_t *event)
The event to post to the active channel.
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.
BPS_SUCCESS when the function completes successfully, BPS_FAILURE with errno value set otherwise.