Show/Hide Toolbars

Licence Protector 5

 

Command no longer in use

 

Replaced with CheckModule

 

Allows to validate, if a license was locked or not. Details see chapter Lock a license / Regular online check.

 

Normally the test is done without a value for the parameter moduleID. Using a module ID creates the same workflow on the Activation Server 6 like a product activation with PrepareAndCheck or WebRegisterExt - e.g. copy protection is activated or additional keys like deleting Demo Version flag are sent.

 

 

Name

CheckLicence                                                                                        

Purpose

Contacts the Activation Server 6 to validate a license. This function has to be used to implement “Moving licenses” and ongoing checks (“renting your software”).

Params

Parameter

Type

Example

Note

Projectname

String

Demo Project

projectname, if empty the internal projectname of the license file is used – identifies the project on the Web Activation Server

ID

String

Abc

Identifier which is used to check and register this license

Module ID

String

D1001

This is the product-name / module ID for the config-autogenerator.xml. It may be empty.

ForceCheck

Boolean

False

If true, CheckLicence will always connect to the Activation Server 6, even if it is not necessary regarding the current values

Returncode

Returncode

Type Integer

Note

0

CheckLicence successful: The online-Validation succeeded or it was not necessary to check the state online

3001

The Web Activation Server was not reachable.

3010

That ID is already used e.g. by another computer.

3018

That ID is locked.

3002-3999

Errors on the Web Activation Server, see Web Activation Documentation

Other return codes

Operation failed, see list of return codes

Usage

Used to validate the license.  

Sample

 

  iRes := lic.CheckLicence(‘’, ‘abc4711’, ‘’, false);

  if iRes = 0 then

  begin

    << license successfully validated >>

     ...

  end

  else if iRes = 3001 then

  begin

    << Web Activation could not be reached, please check connection >>

     ...

  end

  else if iRes = 3010 then

  begin

    << that license is already in usage. Transfer license and then it is free for this computer >>

     ...

  end

  else if iRes = 3018 then

  begin

    << that license is locked on the Web Activation server.>>

     ...

  end

  else

  begin

    << other errors >>>

     ...

   

See also

licenseVerification, NextVerification, Deactivatelicense, SetVerificationID, SetVerificationProduct, WebServiceURL, ShowWAStartPage, ShowWAProgressPage, ShowWAResultPage, UseLocalProxy, UseLocalIEProxy, LocalProxyServer, LocalProxyPort, Projectname

 

 

 

The CheckLicence command would display screens indicating that an online validation is done. The screens can be suppressed using ShowWAStartPage, ShowWAProgressPage and ShowWAResultPage

 

The CheckLicence command triggers the activation workflow file on the server, e.g. activates copy protection and sends out the keys defined in this file.