Properties

DESIGN-TIME PROPERTIES

ColorForm Type: TColor.

The background color of the Registration form. Default clBtnFace.

Font Type: TFont

Text font in the edit fields on the registration form.

Logo Type: TBitmap.

This property allow you to place your own logo on the registration form.

Name  Type: TComponentName.

Inherited from TComponent.

Tag  Type: longint.

Inherited from TComponent.

RUN-TIME PROPERTIES

AccessMode  Type: byte.

This property, stored in the local registry, can take values between 0 and 2

0 : Regular Computer into the trial period. The registration data is obtained from the local registry.

1 : Regular Computer in Registered or Authorized status. The registration data is obtained from the RegFile into the executable directory. 

2 : Master Computer. The registration data is obtained from the RegFile into the executable directory. 

AllowBackDate Type: boolean.

When this value is True then the user is able to backward the system date to reuse an expired period, otherwise the application become expired when the user turn back the system date.

AllowMoveReg Type: boolean.

When this value is True then the Move Registration feature enables through the [Move registration] button displayed in the registration form.

AppID Type: dword.

Numeric value to identify the application. This value is assigned randomly in the AVLockManager utility. You may to change it but make sure to chosse a different value for each application.

AppName Type: string.

Name assigned to your application. Is the name that you enter when you add a new application in the AVLockManager utility.

AppVersionID Type: byte.

Numeric value to identify the application version. The default value is 1 but you should to assign a different value for each different version of your application.

Authorized Type: boolean.

If true, this mean the application is temporarily registered.

BeginDate Type: boolean. 

Date from which start the current authorized period.

Days Type: word. 

Number of days by the current authorized period.

DataStoredIn Type: TDataStoredIn = (Reg_File, Local_Registry);

This property allow you to select where will be stored the registration data. For programs used at personal way into standalone machines, you may select it as Local_Registry or Reg_File. For networking programs this property always must to be Reg_File.

DaysLeftToWarning Type: byte.

The number of days before expiration from where you want to show the TextWarning message. The default value is 15.

EmailAddress Type: string.

Email address used by the users to send you the purchase information.

EncryptionKey Type: date. 

The encryption key used to protect all sensible data as well as the avconfig.ini file and the registration data.

EndDate Type: date. 

Date where finish the authorized period.

Expired Type: boolean. 

When it is True, this mean that trial/authorized period was expired.

FirstTime Type: byte. 

This property can get values between 0 and 3. The start method set its value.

FirstTime=1

RegistryKey exists but not the RegFile.

FirstTime=2

RegFile exists but not the RegistryKey.

FirstTime=3

The program never has been accessed. This is the first time that run on the network. None has been created yet, RegFile or RegistryKey. This mean the current computer will be marked as the MasterComputer creating in the local registry a access mode value m=2.

FirstTime=0

Either exists, the RegFile and the RegistryKey. This mean the program has been accessed sometime by the current computer.  RegFile exists and local registrykey too. This mean that none will be marked at the current computer.

InstallCode Type: string; Length: 6. 

Hexadecimal Strig Value. When your application runs on the user PCs, AVLock Gold calculate a hexadecimal number called InstallCode, distinct one for each PC and calculated from several sources (see InstalCodeSources property). This code must be sent to you from the users so you can generate with the AVLockManager utility the appropriate RegKeys for your users. These are used only for InstallCode based RegKeys.  Upon the Registration form is displayed the extended version of this code (13 digit length) calculated with the exticode method exticode(installcode).

InstallCodeSources Type: set of (Bios_SN, CPU_ID, HD_SN, Random_Number, User_Name).

This property allow you to choose from where the InstallCode property will get its value. The sources may be chosen (one or more) between these ones: Bios_SN (The serial Number from the Bios), CPU_ID (a code from the CPU) and HD_SN (The Hard Disk Serial Number) and Random_Number (value randomly calculated and saved in the local registry the first time that the computer runs) or only User_Name.

The lock strategy depends on these values, as follow:

InstallCode based:  The InstallCodeSources can take these values; Bios_SN, CPU_ID, HD_SN, Random_Number.

UserName based: The InstallCodeSources must be equal to User_Name.

These configurations are accomplished into the "Lock strategy" groupbox onto the "Setings" tabsheet of the AVLockManager utility.

IsTrial Type: boolean.

If true then the app is running at trial mode, otherwise at permanent or temporary authorized way.

LastDate Type: Date.

This property is assigned with the highest date value where the program did run sometime. This allow you to avoid that anyone reutilize an expired period, setting back the system date. AVLockGold compares the current date with LastDate and force the program to expire if LastDate is greater than the current system date.

LocalRegKey Type: string.

Local Registration key coming from the local registry.

LocalUserName Type: string. 

The local user name coming from the local registry.

LocalCompany Type: string. 

The company coming from the local registry.

MasterRegKey Type: string.

Registration key coming from the master registration data..

MasterUserName Type: string. 

The master user name coming from the master registration data.

MasterCompany Type: string. 

Company of the master user coming from the master registration data.

MaxUsers Type: byte.  (Have no effect into the .NET version)

The max number of simultaneous users (instances of your app) allowed by your program into the network.  If you set this value to 0,  the number of simultaneous users will be not restricted.

While the trial period this value is assigned from the avconfig.ini file, later, after the application was registered, this value is assigned from the RegKey saved into the local registry or the RegFile.

ModListCount Type: integer.

Holds the number of defined modules from the avmanager utility into the avconfig.ini file. 

OnlineLink Type: string.

URL to your seller website. A link to this URL will be exposed on the Registration Form allowing to your users an online way to purchase your program.

Options Type: set of (ShowModules, ShowProgress, ShowLoadButton, ShowTopPanel, ShowExpireText, GetLocalName, GetLocalTrial);

This property hold a set of boolean values to manage several things, mainly to configure the registration form.

This property is managed into the "Options for the registration form" and "Options for regular computers" groupboxes onto the "Setings" tabsheet of the AVLockManager utility.

ShowProgress:  If true then will be displayed into the registration form a progress bar with the position of the current date in the authorized period between the initial and final dates.

ShowLoadButton: If true then the [Load from file] button will be displayed in the registration form.

ShowTopPanel: If true then the text message panel on the top of the registration form will be displayed.

ShowExpireText: If true then the expiration text on the registration form is displayed.

GetLocalName: If true then when your program runs the first time in a RegularComputer the program will request to the user to enter his name and company then saves these values into the LocalName and LocalCompany properties and store its values into the local registry.

If False then LocalName and LocalCompany are automatically assigned with the current Windows Username and the ´Unknown´ text.

GetLocalTrial: Only applicable for Regular Computers. If true then when your program runs the first time in a RegularComputer the program will generate a trial period with values stored into the local registry.

If false then the program will automatically  get the MasterComputer registration.

ProgID  Type: string.

Registry key name to store the local registration data.

Prompts and text properties Type: string.

These properties whose values coming from the avlockgold.res file allow you to customize most text messages in the component, . The most proper way to assign values to these properties is changing the resource file. However, you can to modify its values at run time in your program, for example: PromptCompany :='Organization';

Below, a list of these properties with its default values coming from the english res file.

Property               Default Value                            _                                       

PromptHowToRegister    'How to register'

PromptWaysToGet        'Select the method you would like to use

                       to receive your Registration Keys.'

PromptOnline                'Online registration'

PromptViaEmail         'Vie email'

PromptAnotherWay       'Another way'

PromptToRegisterNow    'To register now'

PromptRegInfo1         'Please enter your registration keys,

                       then press the [Register] button'

PromptRegInfo2         'Please enter your registration information

                       then press the [Register] button.'

PromptUserName         'Name:'

PromptCompany          'Company:'

PromptKeys             'Keys:'

PromptBeforeExpire     'Days left to expire:'

PromptAfterExpire      'Trial period expired'

PromptBtnReg           'Register'

PromptBtnCancel        'Cancel'

PromptBtnContinue      'Continue >>'

PromptRegistered       'Keys Registered'

PromptInvalidCode      'Registration Key mismatch'

PromptUserNameTooShort 'User name length too short'

PromptLoadFromFile     'Load from file'

PromptBeforeToRegister 'Before to register this module you must to register the main module'

PromptIsYourCurrent    'is your current registered user name.

                       Do you want to change it?

PromptYouWasTried1     'You have tried to register the module ['

PromptYouWasTried2     '] using a different user name than

                       the one currently registered. This is only

                       allowed for the main module.'

TextWarning            'Warning! You have modules that will be

                       expiring shortly. If you want to continue

                       using these modules please renew your

                       registration.

TextCongratulation1    'Thank you for trying' MYPROGRAM.

TextCongratulation2    'If you find this program useful please register.'

TextExpired            'Trial period expired!  If you want to

                       continue using this program please

                       register it.'

TextToManyUsers        'Too many active users'

TextSendEmail          'Please send this email as is or change

                       the user name and company with the values

                       that you want to register.'

TextEnterName          'Please enter your full user name and

                       company then press the [continue >>]

                       button.'

PromptNameMismatch     'User Name mismatch.'

PromptRegUser          'User successfully registered.'

PromptUnregister       'Module successfully unregistered.'

TextRequestTrial       '. To start with your free trial period please request your

                       Registration Key with the appropriate method listed below.'

FTextRegisteredTo         '. This copy is registered to '

FPromptInstallCode      'InstallCode:'

FTextAuthorizedTo         '. This copy is authorized until the day '

FTextRegistered         ' [ Registered     ]'

FTextNotRegistered         ' [ Not registered ]'

FTextDaysLeft                 ' days left   ]'

FTextModules            'Modules'

FTextInexistentModule   'Inexistent module.'

FTextBadSystemDate      'Bad system date. 

FTextGenericNotAllowed  'Generic keys not allowed here.'

FTextNoKeys             'There are no keys.'

FTextIncorrectKeys      'Incorrect registration key(s).'

FTextClose              'Close'

FTextSave               'Save'

FTextClickSave          'Click [Save] to save to file these registration keys.'

FTextRegDataRemoved     'Your registration data has been removed and your new

                          registration keys (listed below) are ready to be

                          registered to another machine.'

FTextWillRemoveRegData  'Your registration data will be removed in order to

                          translate it to another machine.'

FTextEnterInstallCode   'To proceed enter the InstallCode for the new machine

                          then click [Continue >>] otherwise click [Cancel].'

FTextNoKeysToMove       'There are no keys to move.'

FTextIncorrectICode     'Incorrect InstallCode.'

FTextMoveReg            'Move registration'

FTextHeader1            'Order header 1'

FTextHeader2            'Order header 2'

FTextHeader3            'Order header 3'

RegistrationWays Type: set of (rwOnline, rwEmail, rwOrder).

This property allow you to expose into the registration form the selling method more suitable to your needs. The options are:

rwOnline: Show on the registration form the online link to your seller website according with the value assigned to the OnlineLink property.

rwEmail: Show on the registration form a link to the email address assigned to the EmailAddress property.

rwOrder: From the "Print order form" button the user have the option to print a registration form in order to be posted to you.

RegistryRootKey Type: (CURRENT_USER, LOCAL_MACHINE).

This property allows you to select the appropriate registry rootkey to store the registration data.

You can change this property with the AVLockManager utility from the "Registry rootkey" combobox into the "Settings" tabsheet.

RequestName Type: TREquestName = set of (AtFirstTime, WhenRegister);

When AtFirstTime is True then when your program run the first time on a computer, the program will request to the user to enter his name and company then store its values into the RegFile or into the local registry depending on the DataStoredIn value.

If WhenRegister is True, then, at the registration moment the user is prompted to enter  his name and company.

If  both, AtFirstTime and WhenRegister are False, then the program never will request from the user the name and company, instead will get the user name from Windows and fill the company field with the value ´Unknown´.

Registered Type: boolean. 

If True, then the application is permanently registered. Otherwise is in trial or authorized mode.

RestartModulesAsTrial Type: boolean;

This property is used when a Module-ID value is changed in a new version of your application.

If this value is True, then the implicated module will restart as trial by a period equal to the TrialDays value. Otherwise if the value is False then the implicated module will restart disabled, [Not registered].

Started Type: boolean.

Is true when the Start procedure have been carried out, so the Start procedure take effect only one time although Start be called several times. 

TrialBeginDate Type: TDate.

Date to from where will start the trial period. Only applicable when the TrialMode property is tmAbsolute.

TrialDays Type: word. 

Number of days for the initial trial period. default 30.

TrialMode Type: (tmAbsolute, tmRelative, tmNone).

Determines the type of trial that will be generated  when  the program run the first time. If you chose tmAbsolute, the trial will start with  the date of the TrialBeginDate property,  but if you chose tmRelative, the trial will start with  the current system date. 

TmRelative is more flexible and suitable but tmAbsolute and tmNone are more safely and can not be easily cracked.

The preferred way is with the tmNone value Then, the first time the user runs the app, this become expired and show in the regform a special welcome message to invite the user to request your free trial period. Please see the Hacking Cautions section.

TrialIncludeModules Type: boolean;

If true, then all extra modules will be enabled while the trial period.

UserID Type: dword. 

Code equivalent to the InstallCode calculated from the UserName and used for username based keys.

Warning Type: boolean. 

If True, this mean the Warning Text must be exposed.

If you have any questions not answered by this help file, please don't hesitate to contact me at http://valega.com/contacto.php.