uds_registraion_code_t

An enumeration of registration return codes.

Synopsis:

#include "bb/pim/unified/unified_data_source.h"
 
typedef enum {
      UDS_REGISTRATION_UNKNOWN = 0   
      UDS_REGISTRATION_NEW = 1   
      UDS_REGISTRATION_EXISTS = 2   
      UDS_REGISTRATION_ERROR =3   
} uds_registraion_code_t;

Since:

BlackBerry 10.2.0

Data:

UDS_REGISTRATION_UNKNOWN
Indicates that an unknown error occurred and that registration was not completed.

Note that this is currently a placeholder value and is not supported at this time.

UDS_REGISTRATION_NEW
Indicates that the registration was completed successfully and that it is a new registration.

This code is returned from uds_register_client() the first time your app registers with the BlackBerry Hub. It's also returned after an over-the-air (OTA) upgrade of the device OS that results in a schema change to the BlackBerry Hub. This code indicates that this is a fresh registration, so your app should add its data to the BlackBerry Hub, such as accounts, inbox list items, and so on.

UDS_REGISTRATION_EXISTS
Indicates that your app has already registered.

This code is returned from uds_register_client() if your app has already completed a successful registration with the BlackBerry Hub and has restarted. This code indicates that your app doesn't need to add its data (such as accounts or inbox list items) to the BlackBerry Hub again, if it already added the data previously.

UDS_REGISTRATION_ERROR
Indicates that an error occurred and that registration was not completed.

Note that this is currently a placeholder value and is not supported at this time.

Library:

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

Description:

These codes are returned by the uds_register_client() function and indicate the status of registration with the BlackBerry Hub. These codes indicate whether the registration is new, whether your app has already registered with the BlackBerry Hub, or whether a registration error occurred.