bbads_banner_request_events()

Register a banner for asynchronous event delivery through the BlackBerry Platform Services (BPS).

Synopsis:

#include <bbads/bbads.h>
 
bbads_error_t bbads_banner_request_events(bbads_banner_t *banner)

Since:

BlackBerry 10.0.0

Arguments:

banner

The bbads_banner_t* as created in the call to bbads_banner_create().

Library:

libbbads

Description:

Use this function to activate event delivery, through BPS, for a banner.

Returns:

  • BBADS_EOK on success.
  • BBADS_EBANNER if the bbads_banner_t* provided is invalid.
  • BBADS_ESTATE if the banner has already been registered for asynchronous event delivery. You need to deregister the banner before you can re-register it for asynchronous event delivery. See bbads_banner_stop_events() for more information.