Setting Product Edition

The ruiSetProductEdition() function allows you to set the edition of your product. An example of this would be when a single product can be licensed/run in different modes such as “Home” and “Business”.

ruiSetProductEdition()

RUIRESULT ruiSetProductEdition(RUIINSTANCE* ruiInstance, const char* productEdition)

Parameters

The ruiSetProductEdition() function has the following parameters.

ruiSetProductEdition()Parameters

Parameter

Description

ruiInstance (RUIINSTANCE*)

Pointer to the Usage Intelligence instance created via ruiCreateInstance().

productEdition (const char*)

The product edition that is to be set. Maximum length of 128 characters.

Note:A NULL value removes any previous value

Returns

The ruiSetProductEdition() function returns one of the return status constants below.

ruiSetProductEdition() Returns

Return

Description

RUI_OK

Function successful.

RUI_INVALID_SDK_OBJECT

SDK Instance parameter is NULL or invalid.

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. ruiStopSDK() and ruiDestroyInstance() 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.