bbmsp_user_profile_box_item_copy()

Create a copy of a profile box item.

Synopsis:

#include "bbmsp/bbmsp_user_profile_box.h"
 

BBMSP_API bbmsp_result_t bbmsp_user_profile_box_item_copy(bbmsp_user_profile_box_item_t *destination_item, bbmsp_user_profile_box_item_t *source_item)

Since:

BlackBerry 10.0.0

Arguments:

destination_item

A pointer to an item created using bbmsp_user_profile_box_item_create().

source_item

A pointer to the profile box item to copy.

Library:

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

Description:

Once your app finishes processing a profile box event and returns to the BlackBerry Platform Services (BPS) event loop, the BPS library releases the original BPS event from memory, including the profile box item. This function copies a profile box item into memory for use after your app calls bps_get_event() again.

Returns:

BBMSP_SUCCESS if successful, BBMSP_FAILURE otherwise.

Parent topic: Functions in bbmsp_user_profile_box.h