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.

Last modified: 2014-09-30



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus