Setting Product Language
The RUISDK.SetProductLanguage function allows you to set the language that the client is viewing your product. This is useful for products that have been internationalized, so you can determine how many installations are running your software in a particular language.
Note:The product data must be set every time the SDK instance is run. This is different than V4 of the Usage Intelligence (Trackerbird) SDK where the supplied product data was stored in the SDK configuration file and if it was not supplied, the values in the configuration file were used.
RUISDK.SetProductLanguage can be called between RUISDK.CreateConfig and RUISDK.StopSDK and can be called zero or more times.
RUISDK.SetProductLanguage is a synchronous function returning when all functionality is completed.
RUIResult RUISDK.SetProductLanguage (String productLanguage)
Parameters
The RUISDK.SetProductLanguage function has the following parameters.
|
Parameter |
Description |
|
productLanguage (String) |
The product language that is to be set. Maximum length of 128 characters. |
Returns
The RUISDK.SetProductLanguage function returns a RUIResult enum value with the following possible values:
|
Return |
Description |
|
ok |
Function successful. |
|
sdkInternalErrorFatal |
Irrecoverable internal fatal error. No further API calls should be made. |
|
sdkAborted |
A required New Registration has failed, and hence the SDK is aborted. RUISDK.StopSDK and RUISDK destructor are possible. |
|
sdkSuspended |
The Server has instructed a temporary back-off. |
|
sdkPermantelyDisabled |
The Server has instructed a permanent disable. |
|
sdkOptedOut |
|
|
configNotCreated |
Configuration has not been successfully created. |
|
sdkAlreadyStopped |
SDK has already been successfully stopped. |