bbmsp_contact_get_ppid()

Retrieve a contact's PPID.

Synopsis:

#include <bbmsp/bbmsp_contactlist.h>
 
BBMSP_API bbmsp_result_t bbmsp_contact_get_ppid(const bbmsp_contact_t *contact, char *ppid, size_t ppid_buffer_size)

Since:

BlackBerry 10.0.0

Arguments:

contact

A pointer to the contact whose PPID to get.

ppid

A buffer that will be updated with the PPID encoded as Base64. The resulting buffer will be null-terminated on success.

ppid_buffer_size

The size of the ppid buffer. This should be BBMSP_CONTACT_PPID_MAX.

Library:

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

Description:

The user's PPID is the same across multiple instances of BBM (for example, on a BlackBerry smartphone and a BlackBerry tablet), when the user signs in with the same BlackBerry ID. PPID is encoded as a Base64 string using the ASCII character set.

Returns:

BBMSP_SUCCESS if successful, BBMSP_FAILURE otherwise.