Setting Product Build Number

The ruiSetProductBuildNumber() function is used to set the build number of the application being run.

ruiSetProductBuildNumber()

RUIRESULT ruiSetProductBuildNumber(RUIINSTANCE* ruiInstance, const char* productBuildNumber)

Parameters

The ruiSetProductBuildNumber() function has the following parameters.

ruiSetProductBuildNumber() Parameters

Parameter

Description

ruiInstance (RUIINSTANCE*)

Pointer to the RUI instance created via ruiCreateInstance().

productBuildNumber (const char*)

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

Note:A NULL value removes any previous value

Returns

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

ruiSetProductBuildNumber() 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.