bbmsp_user_profile_box_get_item()

Retrieve an item from a profile box by using the item ID.

Synopsis:

#include "bbmsp/bbmsp_user_profile_box.h"

BBMSP_API bbmsp_result_t bbmsp_user_profile_box_get_item(const char *id, bbmsp_user_profile_box_item_t *item)

Since:

BlackBerry 10.0.0

Arguments:

id: A pointer to the buffer that contains the item ID. id must be passed in as a null-terminated C-string, encoded as UTF-8.

item: An updated pointer to the item.

Library:

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

Description:

Each profile box item is identified by a unique, non-negative, numeric ID. If bbmsp_can_show_profile_box() returns false, this method will return BBMSP_FAILURE.

Returns:

BBMSP_SUCCESS if successful, BBMSP_FAILURE otherwise.