Licence Protector

CheckLicence

Hide Navigation Pane

CheckLicence

 Previous topic Next topic  

CheckLicence

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

 

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 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 Licence Protector Web Activation server 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, 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

 

 

Ports and Proxy Settings

 

The Online Activation uses an http request on Port 80 to communicate with the Activation Server. A router with a standard firewall (IP-Filter) will not detect the difference to a Browser request and let the activation pass. A local personal firewall like McAfee or Norton will pop-up and ask, if the request should be permitted. Only a 'real' application firewall will block the request and an administrator has to open port 80.

 

Proxy settings are retrieved from the Browser but can be changed with the commands LocalProxPort, LocalProxyServer, UseLocalIIEProxy, UseLocalProxy.

 

Only the Licence Protector DLL can talk to the Activation Server.

 

 

 

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. If you send out a key which calculates a date (e.g. because you have a time limited full version), then you should make a new configuration file for the regular online check by using a different project name in the CheckLicence call.