bbads_banner_create()

Create a new banner.

Synopsis:

#include <bbads/bbads.h>

bbads_error_t bbads_banner_create(bbads_banner_t **banner, screen_window_t window, const char *window_group_name, unsigned int zone_id)

Since:

BlackBerry 10.0.0

Arguments:

banner: This points to the location where the created bbads_banner_t* will be set.

window: The top-level screen_window_t of the application.

window_group_name: The group name of the top-level screen_window_t of the application.

zone_id: The zone ID identifies your application to the Advertising Service, and allows you to manage ad streams for your app using the web portal for the Advertising Service. The trial zone ID is 117145. This property is required.

Library:

libbbads

Description:

Creating a new banner will initialize it with the default parameters.

Once the banner has been created, its parameters can be modified by calling other functions.

Returns:

BBADS_EOK if a banner was created successfully and the value in banner was set.
BBADS_ENOMEM if memory for the banner could not be allocated.