To alter some modules you can use the function SetVal(). To retrieve the information, use GetVal().
Its parameters are a module ID and a token. If you call SetVal() with an empty module ID, it is supposed to change a value inside the license. Take a look in the token list to see which tokens could be used:
Token |
Changed value |
Data type |
Purpose |
Similar function |
Tokens for the whole license (Parameter ModuleID of SetVal/GetVal has to be an empty string) |
||||
Customer |
String |
|||
OEM |
Manufacturer |
String |
||
FID |
FileID |
Integer |
||
VSN |
Version |
Integer |
Version of the license file format |
|
CPT |
CopyProtectType |
Integer |
||
ICO |
InstCode |
String |
With GetVal this token retrieves the hardware ID (8 digit code), which has been used for copy protection. Using SetVal you can activate copy protection .
B3F5AA23 is the code for no InstCode |
Retrieve the hardware ID of the computer with GetInstcode |
Tag |
String |
|||
MID |
Main module ID |
String |
Change the main module ID - default ID is set in the project template |
|
PRJ |
Projectname |
String |
Projectname |
|
WSU |
WebServiceURL |
String |
WebServiceURL |
|
SWS |
ShowWAStartPage |
Boolean |
GetVal() returns ‘true’ or ‘false’ SetVal() accepts values ‘true’, ‘false’, ‘1’, ‘0’, ‘on’, ‘off’, ‘yes’, ‘no’ |
|
SWP |
ShowWAProgressPage |
Boolean |
GetVal() returns ‘true’ or ‘false’ SetVal() accepts values ‘true’, ‘false’, ‘1’, ‘0’, ‘on’, ‘off’, ‘yes’, ‘no’ |
|
SWR |
ShowWAResultPage |
Boolean |
GetVal() returns ‘true’ or ‘false’ SetVal() accepts values ‘true’, ‘false’, ‘1’, ‘0’, ‘on’, ‘off’, ‘yes’, ‘no’ |
|
LVI |
LicenceVerification |
Integer |
values see LicenceVerification - details see Regular online check |
|
NVI |
NextVerification |
Date |
set next online verification date - details see Regular online check |
|
EVI |
EndVerification |
Date |
set end verification date - details see Regular online check |
|
VER |
Application Version |
String |
Application Version number - can also be added in the License Generator, screen License Main. |
|
VID |
VerificationID |
String |
see command SetVerificationID |
|
VPR |
VerificationProduct |
String |
see command SetVerificationProduct |
|
RES |
Reseller |
String |
Name of the reseller - can also be added in the License Generator, screen License Main. |
|
SEL |
SecurityLevel |
Integer |
||
TDM |
TamperDetectionMode |
Integer |
||
TDG |
TamperDetection GraceTimes |
Integer |
||
CLC |
TamperDetection |
Boolean |
||
ALW |
AllowSetVal |
Boolean |
||
URL |
AllowChangeWASURL |
Boolean |
||
Commands for license file upload (UploadLic) |
||||
LUI |
ID for upload |
String |
ID used for upload |
|
LUJ |
Project Name |
String |
Project name used for upload |
|
LUL |
Name |
String |
Name to identify the license file |
|
LUM |
Module ID |
String |
Module ID used for upload |
|
LUP |
Date / TIME |
Date |
Date / Time of the last upload |
|
|
||||
ALW |
Allow |
Boolean |
GetVal() returns ‘true’ or ‘false’ SetVal() accepts values ‘true’, ‘false’, ‘1’, ‘0’, ‘on’, ‘off’, ‘yes’, ‘no’ |
|
CHI |
CheckInterval |
Integer |
CheckInterval value |
|
CSK |
CopyProtectionSwitchOnKey |
String |
value available for backward compatibility and is no longer in use |
|
CSO |
CopyProtectionSwitchOffKey |
String |
value available for backward compatibility and is no longer in use |
|
DMO |
Demo |
Boolean |
GetVal() returns ‘true’ or ‘false’ SetVal() accepts values ‘true’, ‘false’, ‘1’, ‘0’, ‘on’, ‘off’, ‘yes’, ‘no’ |
|
DPC |
DiffPct |
Integer |
||
EMV |
EndModuleVerification |
Date |
set end verification date - details see Regular online check |
see also token NMV, MVI, MVD |
EXO |
ExpiredOn |
Date |
Accepted values are in ISO-format YYYY-MM-DD 1899-12-30 is the value for an empty date |
ExpiredOn value |
Last Activation Date |
Date |
Date, when the product was activated 1899-12-30 is the value for an empty date |
||
Last ActivationMethod |
Integer |
Retrieves the method, how a module activation was done
-1 = none 0 = Online 1 = e-mail 2 = Fax 3 = Phone |
||
MOI |
ModuleID |
String |
Get or Set a module ID |
|
TLI |
Totallicenses/Value |
String |
Set the value of a module - e.g. Yes/No or number of licenses for a network or counter module |
|
licenseType |
String |
Values are ‘U’ à license per named user ‘S’ à license per computer ‘C’ à Counter ‘Y’ à yes/no ‘I’ à license per item ‘R’ à Concurrent user |
||
NMV |
NextModuleVerification |
Date |
set next online verification date - details see Regular online check |
see also token MVI, EMV, MVD |
NOD |
NoOfDays |
Integer |
||
MEO |
MaxExpiredOn |
Date |
||
MON |
ModuleName |
String |
||
Keys |
String |
All standard keys for that module, separated by semicolon, including hidden keys |
||
MYS |
Keys |
String |
All standard keys for that module, separated by semicolon. Hidden keys are displayed as ***** |
|
MVD |
ModuleVerificationID |
String |
used in case the ID is left empty in the CheckModuleSubscription or CheckModule command |
see also token NMV, EMV, MVI |
MVI |
ModuleVerification |
Integer |
Values are 0 = off 1 = ongoing / enabled 2 = frozen 3 = deactivated details see Regular online check |
see also token NMV, EMV, MVD |
REM |
RegisteredEMail |
String |
e-mail address of the registration. If multiple modules are registered, the e-mail address is saved per module |
|
RNM |
RegisteredCustomerName |
String |
if multiple modules are registered, the name is saved per module. The main customer name in the license file can be retrieved with token CST |
|
ActivationState after copy protection is turned on |
Integer |
Details see activation status after product activation |
||
Grace Days |
Integer |
Number of days for the grace period in case the online validation with CheckModuleSubscription fails. Return value is integer (e.g. 2 days). Definition of grace days done with SetSubGraceDays |
0 = no grace days |
|
Grace Period - Expiry Date |
Date |
Expiry Date of the grace period |
||
SerialNumber |
String |
Retrieves the Serial Number |
||
Tag |
String |
|||
EasyGoWorkflow |
Integer |
Workflow defined in the project template or with SetRegisterSettings. |
||
WebActivation |
Integer |
0 = none 1 = required 2 = done 3 = erroneous |
If you want to activate copy protection using a DLL command, the workflow would be
•Use PrepareForce to open the license file
•SetVal, Token CPT to set the copy protection type (e.g. 2 = MAC Address)
•Use GetInstcode to retrieve the installation code
•SetVal, Token ICO using as parameter the 8-digit installation code retrieved with GetInstcode
•Quit