Licence Protector

Source Code Integration

Hide Navigation Pane

Source Code Integration

Previous topic Next topic No directory for this topic  

Source Code Integration

Previous topic Next topic Topic directory requires JavaScript JavaScript is required for the print function Mail us feedback on this topic!  

 

Within your Source Code you use the EasyGo commands and some additional checks.

 

Use SetLanguage, SecurityLevel, SetRegisterSettings

Open your license file by starting EasyGo with PrepareAndCheck

Check if the version is already activated because only then you need to perform the additional online check - GetWebActivation using the main module ID would return 2 = application is activated

By default, the  online check  is transparent for the customer by displaying the following 3 screens.

 

Click on image 
Start Screen (ShowWAStartPage)
Click on image
Progess Screen (ShowWAProgressPage)

Click on image 
Result Screen (ShowWAResultPage)

 

 

The dialogs could be deactivated either with the settings <ShowWAStartPage>, <ShowWAProgressPage>, <ShowWAResultpage> in the project template or with the commands ShowWAStartPage, ShowWAProgressPage, ShowWAResultPage in the source code.

 

 

If the product is already activated,

 

Retrieve the Serial Number using GetSerial

Enable the regular online check of this module with VerificationOfModule = true. Note: The current status can be retrieved using GetVerificationOfModule

Perform the online check with CheckModuleSubscription (with grace period) or CheckModule (no grace period) and specifying the main module number and using the Serial Number as ID, download full license should be set to false (no download of license file).

 

Licence Protector will go online only if the next check is due. Otherwise Licence Protector will just continue without going online. Note: GetNextVerificationOfModule will retrieve the date, when the next online check is due

 

The check is documented on the Activation Server with request type check license.

 

The next date to go online is retrieved from the configuration file project.config with the parameter <CheckLicenceDays> - see Configuration Settings. The new date for the next online verification is stored in the license file. It can be changed using NextVerificationOfModule

 

Program logic depending on the results of CheckModuleSubscription

 

Only continue in your application if error code is 0

If error code is 3018 then the license is locked on the Activation Server (see how to lock the license). Your application should terminate. The next start of the application will always go online to check if the license is still locked

If error code is 3001 then no online connection could be established

 

Grace period

In case the connection to the Activation Server fails,  a grace period is activated (if value of grace period >0) . Details see CheckModuleSubscription

 

Use SetSubGraceDays to overwrite the default value of the template <SubGraceDays>

Use GetVal, Token SGD to retrieve the number of grace time in full days (integer value) - set with SetSubGraceDays

Use GetRemainingSubgraceDays to retrieve the remaining grace time as an exact double value (e.g. 2.8765 days)

Use GetVal, Token SGP to retrieve the expiry date/time of the grace period (date/time value)

 

 

Options to control the regular online check

By default, the first date for the regular online check is used from the configuration file on the Activation Server, <CheckLicenceDays>

A date for the first/next online validation could be set with NextVerificationOfModule. It also allows to retrieve the date for the next regular online check

Get or Set the date, when the last online check is planned with EndVerificationOfModule. After this date, all checks are terminated

The current status can be retrieved using GetVerificationOfModule

Set the grace period