bbmsp_register()

Register your app with the BBM Social Platform.

Synopsis:

#include <bbmsp/bbmsp.h>
 
BBMSP_API bbmsp_result_t bbmsp_register(const char *uuid)

Since:

BlackBerry 10.0.0

Arguments:

uuid

A pointer to your app's UUID. uuid must be a null-terminated C-string, encoded as UTF-8.

Library:

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

Description:

A UUID is a unique, 128-bit, 36-character identifier that you generate for your app using a UUID (or GUID) generator. The UUID string must conform to the Microsoft 8-4-4-4-12 format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Valid characters consist of hexadecimal values in the ranges 0 to 9 and a to f.

A progress registration dialog may appear in your application after you invoke this function. The user will be able to cancel the registration by dismissing the dialog. After registration is complete, a system toast might appear to indicate to the user that your application is now connected to BBM. If registration does not complete successfully, a system dialog might appear informing the user about the reason for failure.

If permission to connect to BBM is not set up when registration starts, the user may decide to set up BBM. This action will cause registration to resume.

This is an asynchronous request. The response will be an event with category BBMSP_REGISTRATION and event type BBMSP_SP_EVENT_ACCESS_CHANGED.

Returns:

BBMSP_ASYNC if the request was sent successfully, BBMSP_FAILURE otherwise.

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus