Changing ReachOut on Autosync Setting

The flag to determine whether or not a ReachOut should be requested as part of each SDK Automatic Sync is initially set in the createConfig call. There may be certain cases when the application wants to either enable or disable this functionality during the application lifetime.

The setReachOutOnAutoSync: function allows the application to enable or disable this capability after createConfig has been called.

The setReachOutOnAutoSync: function enables (true) or disables (false) the ReachOut on Autosync capability.

Note:If the call does not change the existing setting, the API will still return OK.

setReachOutOnAutoSync:

(RUIRESULTOBJC) setReachOutOnAutoSync: (BOOL)reachOutOnAutoSyncSetting

Parameters

The setReachOutOnAutoSync: function has the following parameters.

setReachOutOnAutoSync: Parameters

Parameter

Description

reachOutOnAutoSyncSetting (BOOL)

Set to enable (YES) or disable (NO) ReachOut on Autosync setting.

Returns

The setReachOutOnAutoSync: function returns one of the return status constants below.

setReachOutOnAutoSync: Returns

Return

Description

RUI_OK

Function successful.

RUI_SDK_INTERNAL_ERROR_FATAL

Irrecoverable internal fatal error. No further API calls should be made.

RUI_SDK_ABORTED

A required New Registration has failed, and hence the SDK is aborted. stopSDK: and Objective-C instance release are possible.

RUI_SDK_SUSPENDED

The Server has instructed a temporary back-off.

RUI_SDK_PERMANENTLY_DISABLED

The Server has instructed a permanent disable.

RUI_SDK_OPTED_OUT

Instance has been instructed by the application to opt-out.

RUI_CONFIG_NOT_CREATED

Configuration has not been successfully created.

RUI_SDK_ALREADY_STOPPED

SDK has already been successfully stopped.