This chapter discusses how to installl Sequel registration codes on a computer.
Unlike versions less than 2.0 one, license can be added only with taken of special library - SequelInstall.dll file. The sequel.dll only verifies installed licenses, but doesn't manage them. It exports following routine to add a registration code:
procedure UseLicense(ALicense:pchar; ADestination:pchar); stdcall;
void stdcall UseLicense(char *ALicense, char *ADestination);
You have to pass a registration code to the ALicense parameter, while ADirectory parameter will determine a directory, where the licensing information will be stored. This must be directory where the sequel.dll file is deployed and registered; else Sequel will not be able to recognize licensing data. Files named Sequel.License and Sequel.License2 hold them. It is not necessary that string holding the output directory must end with the backslash.
When you call this routine with a pointer to a valid registration code, then it will be added (installed) if it not already installed and ignored if already installed. Any invalid registration code will be ignored too.
This routine handles all categories of Sequel registration codes. When you're making a setup program of your application, you should call this routine with one of your valid registration codes when application is being installed. This ensures the proper registration code handling.
If no registration code is present (installed), Sequel may time by time display a message on screen or dump a message into a file to report its unregistered status.
The SequelInstall.dll file also exports routine named UseLicenseDefault:
procedure UseLicenseDefault(ALicense:pchar); stdcall;
void stdcall UseLicenseDefault(char *ALicense);
Unlike UseLicese, this one operates on the Sequel.License file located at SequelShared.
NSIS Installer
This library exports routine named NSISUseLicense. Its behavior is equal to UseLicense($0, $OUTDIR).
GP-Install
There's a routine named GPIUseLicenseDefault in this library. It can act as GP-Install extension and its behavior is equal to UseLicense(pAdditional).