Licence Protector 5

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

DownloadLic

This command allows you to download a complete license file (including all hidden information) from the Activation Server 6. It can be uploaded with the command UploadLic.

Values (e.g. a module or data area information) which are removed on the server, are still available in the local file. To download a one to one copy use DownloadWholeLic

This command requires a license file which was opened using one of the Prepare commands.

Name

DownloadLic

Purpose

Downloads the license file from to the Activation Server 6. A unique ID is necessary to store the license file on the Activation Server 6. If the ID already exists, the data is overwritten.

Params

Parameter	Type	Example	Note
Projectname	String	demo-easygo	Project name. If empty the internal project name of the license file is used
ModuleID	String	QHD001	module ID - If ModuleID is empty a CheckLicence call is used to locate the Activation
ID	String	IV0078	unique ID to store the license file. Could be a customer ID or a Serial number
Name	String	default	name to identify the license file. One ID can store multiple files using different names like default-backup-January2010 default-backup-February2010
Encryption Code	String	this is like a password string	ensures, that a file can only be downloaded when a password is provided. The password has to be set with the command UploadLic. Should be maximum 40 characters.
DownloadFull	Boolean	true	If true, the complete license file is downloaded. Otherwise only the changes made on the Activation Server 6 are downloaded and updated in the local license file. Values removed on the server will not be removed in the local file

Returncode

Returncode Type Integer	Note
0	license file successfully downloaded
3001	The Activation Server 6 was not reachable.
3014	Most likely wrong encryption code or the length of the encryption code exceeds 40 characters or problem with the time difference between client and Activation Server 6
3015	Key / ID does not exist. An ID was used where no license file is assigned on the Activation Server 6 . The ID must match the ID used with UploadLic
3040	Name of the license file in combination with the used ID does not exist or the length of the encryption code exceeds 40 characters
3002-3999	Errors on the Activation Server 6, see Activation Server 6 error codes
Other return codes	Operation failed, see list of return codes

Usage

Used to download a license file or only modifications. The license file can be edited on the Activation Server 6 and the file has first to be uploaded using the command UploadLic.

Sample

iRes := lic.DownloadLic(‘’, ‘QHD001’, ‘IV0078’, ‘Default’, ‘mypassword76R§",true);

if iRes = 0 then

begin

<< Licence successfully downloaded >>

...

end

else if iRes = 3001 then

begin

<< Activation Server 6 could not be reached, please check connection >>

...

end

else

begin

<< other errors >>>

...