notification_notify()

Request a notify notification with members specified in message.

Synopsis:

#include <bps/notification.h>

BPS_API int notification_notify(notification_message_t *message)

Since:

BlackBerry 10.0.0

Arguments:

message: The data members of the notification.

Library:

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

Description:

The notification_notify() function requests a notify notification message. This notification message supplies the information needed to create various types of notifications.

We recommend that the sender of the notification provide as much data as possible so that the notification may be presented according to the user's settings.

The members required by a notify notification are:

item_id

The additional members that notify will consider are:

title
subtitle
sound_url
invocation_target
invocation_payload
invocation_payload_uri
invocation_type
invocation_action
request_id

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.