deviceinfo_get_identifying

Retrieve the device identifying information.

Synopsis:

#include <bps/deviceinfo.h>

BPS_API int deviceinfo_get_identifying_details(deviceinfo_identifying_details_t **details)

Since:

BlackBerry 10.0.0

Arguments:

details: This will be populated with the device identifying information. The caller must call deviceinfo_free_identifying_details() when done with this structure.

Library:

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

Description:

The deviceinfo_get_identifying_details() function gets the device identifying information. This function requires the application to have the read_device_identifying_information capability. To grant an application the read_device_identifying_information capability, the bar-descriptor.xml file in the application's project must contain the line "<permission>read_device_identifying_information</permission>".

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.