Licence Protector 5

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

PrepareForce

This command allows to open a license file even if one of the following major errors occur:

•Copy Protection error

•System Date manipulation with CheckSysdateChanged

In case of an error with the command Prepare, this command allows to open the license file and e.g. display the License Viewer to type in a key.

You have to set the SecurityLevel before you can use this command

Name

PrepareForce

Purpose

Prepares the Licence Protector instance for usage and opens the license file. If a license file can’t be opened due to major errors, this command allows to open the file and e.g. display the License Viewer to type in a key

Params

Parameter

Type

Example

Note

license file

String

F:\mylic.lic

The full path to the license file. See details for UNC pathnames

ProjectSecureKey or ReadKey

String

I am a project secure key

Security Level BASIC:

The project secure key for that license file. Can contain any characters. The minimum length is 6 characters, the recommended length is 15 and greater

Security Level ADVANCED:

The Read Key for that license file. It can not be chosen freely but has to be created using the Create Project Keys function in License Generator.

Returncode

Returncode Type Integer	Note
0	The license file was successfully opened
2	The license file could not be found or was not opened
16382	If CheckSysdateChanges is set to true and Licence Protector 5 recognizes that the date was manipulated then you get this error code.
16384 or 2048	The file to open is not a valid license file or it has another security level: You can not open a license file of security level ADVANCED using its PSK. You need its Read Key.
Other return codes	Prepare failed, see list of return codes

Usage

Normally Prepare should be used! PrepareForce can be used for administration tools that have to be able to open every known license file. Dependant of property SecurityLevel PrepareForce can open license files with Security Level BASIC (=0, default) or files with Security Level ADVANCED (=1).

Note: PrepareForce can’t open license files where the PSK is unknown. Only the Installation Code is ignored.

Sample

lic.SecurityLevel := 0; // the following PrepareForce uses SecurityLevel BASIC and needs a PSK

// at 1, PrepareForce uses SecurityLevel ADVANCED and needs a ReadKey

iRes := lic.PrepareForce(sMyLicfile, ‘I am a project secure key’);

if iRes <> 0 then

begin

<< an error occurred >>

...

end

else

begin

<< everything is fine, continue >>

...