bbmsp_event_user_profile_box_item_added_get_item()

Retrieve an item that was added to a user's profile box.

Synopsis:

#include "bbmsp/bbmsp_user_profile_box.h"

BBMSP_API bbmsp_result_t bbmsp_event_user_profile_box_item_added_get_item(bbmsp_event_t *event, bbmsp_user_profile_box_item_t *item)

Since:

BlackBerry 10.0.0

Arguments:

event: A pointer to the event that was triggered when the user added the item.

item: An updated pointer to the item that was added.

Library:

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

Description:

When an item is added to a user's profile box, the BBMSP_SP_EVENT_USER_PROFILE_BOX_ITEM_ADDED event is triggered. If bbmsp_can_show_profile_box() returns false, this method will return BBMSP_FAILURE.

Returns:

BBMSP_SUCCESS if successful, BBMSP_FAILURE otherwise.