Licence Protector 5

Navigation: Function Reference and Error Codes > Commands in Alphabetical Order

TakeOverLicFile

This command converts an old license file of a version 2.x and 3.x into version 4. The complete file structure of the old file (including keys, system data etc.) is transferred to the new file. Even old Serial Numbers can be used after the conversion is done.

It requires to additionally install and register the file LicProtector314.dll. You need a license file version 4 to move a version 2.x or 3.x into the new file format.

Before you can use the API command, you have to open the new license with one of the Prepare commands.

Suggested workflow

•Open the new license file (version 4) with PrepareForce

•Open the old license file (version 2.x or 3.x) with PrepareForce

•Use TakeOverLicFile

•Close all license files using Quit

Name

TakeOverLicFile

Purpose

Converts license file version 2.x and 3.x into version 4.x

Params

Parameter	Type	Example	Note
File_to_take_over	String	F:\mylicv3.lic	Old license file name The full path to the old license file. See details for UNC pathnames
ReadKey_or_PSK	String	r1lkYAp1xG QN81fBrcZ 1dfXtw1doy 3Z1l4KH1...	ReadKey of the old license file. For license files created without an ReadKey (security level = 0) the PSK has to be used
SecurityLevel	Integer	1	Security Level •1 = Advanced = default for projects using a ReadKey •0 = Basic = old projects using a PSK
File_to_take_over_has_at_least_version4	Boolean	False	Old license file is version 4 or higher Use false to convert license files from version 2.x and 3.x.
Keep_PSK_of_file_to_take_over	Boolean	False	Defines if the PSK (key encryption) of new file should be used or if the PSK of the old file should be kept •Use false to keep the PSK if you want to use old Serial Numbers / Activation Keys with the new file •Use true to use the PSK generated with the new file template

Returncode

Type Integer

Note

License conversion was successful

Other return codes

Operation failed, see list of return codes

Usage

Used to validate the license.

Sample

iRes := lic.TakeOverLicFile(‘F:\mylicv3.lic’, ‘r1lkYAp1xG

QN81fBrcZ...’,1,false, false);

if iRes = 0 then

begin

<< license conversion successful >>

...

end

<< other errors >>>

...