Programming notes are simply HTML documents that are created when you compile your license project that aid you in integrating your license into your application.

These files are named the same as the project, except with an ".html" extension. For example, if your Main License File name is "App1MainLicenseFile.ini" then, when you compile your license project, a programming notes file will be created named "App1MainLicenseFile.html".

Inside the programming notes file is important information that helps you call the StartUp method of the ClientProtector component.

A sample of the contents of a typical programming notes file follows:

---

SoftwareShield
Programming Notes for: LicenseV3_9.ini

(Compiled at: 07/03/2004 5:23:23 PM)

---

General Details:

Host Product Name	Test Host 9
Host Product Description	Test Description 9
Serial Number	test
User Company Name	Co Name
User Name	User
User Address 1	n/a
User Address 2	n/a
User Address 3	n/a
User Phone Number	n/a
User Email Address	n/a

 

Virgin Registry Information:

Virgin Registry Information is Not Used
Virgin Key Root	N/A
Virgin Key Path	N/A
Virgin Key Value Name	N/A
Virgin Key Value	N/A

 

Alias License Files:

Number Of Alias Files: 5
Alias File #	Alias File Kind	Alias File Name	Alias File GUID	Alias File Location / ROOT KEY
# 0	Hidden	ms41ms.dll	N/A	Main License File Folder
# 1	Registry	N/A	{C26AEADF-C2FF-4BBD-A7DF-62AF2EC22399}	HKEY_CURRENT_USER
# 2	Steganographic	Logo2.bmp	N/A	N/A
# 3	Hidden	ms255db.tlb	N/A	Main License File Folder
# 4	Hidden	cc868tiff.bin	N/A	Main License File Folder

 

System FingerPrint:

FingerPrint Options Code: 1455235

This FingerPrint Options Code corresponds to setting: Hard Drive Model, Hard Drive Hardware Serial No., Windows Serial Number, Operating System Build Number, Operating System "Windows" Directory, Operating System "Temp" Directory, Machine Platform Type, MAC Address of Network Interface Card 1, User Name.

 

Authorization Definitions:

Authorization Definition ID #	Description	Authorization Definition Kind	Parameter Description
0	release copy pro	RELEASE Copy Protection
1	recover license	RECOVER From Failure
2	release all expiration	RELEASE All Expiration
3	change expire date	CHANGE Hard Expire Date
4	add exes	ADD Allowable Executions
5	Pay Per Use Tracker	GENERAL Use	parameter holds the number of pre-paid uses remaining in the license

 

License Behaviour:

Copy Protection	Disabled
FingerPrint All Activation Codes	Activation Codes Are FingerPrinted
Prompt For Recovery	Will Prompt
Auto Recover	Will Not Auto-Recover
Auto Main License Replace	Will Not Replace Main License
Resist User Debuggers	Resist User Debuggers Not Enabled
Resist SoftICE	Resist SoftICE Not Enabled
Resist Tracers	Resist Tracers Not Enabled

Expiration:

LicenseV3_9.ini DOES Expire.
Expire Hard Date	21/06/2002
Expire Period	5 Days.
Execution Limit	5 Executions.
Date Time Last Used Setting	04/11/2002 1:47:00 PM

 

User Defined Fields:

User Defined Field	Value
String #0	(empty)
String #1	(empty)
String #2	(empty)
String #3	(empty)
String #4	(empty)
String #5	(empty)
String #6	(empty)
String #7	(empty)
String #8	(empty)
String #9	(empty)
Date #0	30/12/1899
Date #1	30/12/1899
Date #2	30/12/1899
Date #3	30/12/1899
Date #4	30/12/1899
Number #0	0
Number #1	0
Number #2	0
Number #3	0
Number #4	0

 

---

Critical StartUp Details:

In your FormLoad event or startup of application, call the StartUp function of the ClientProtector COM object with the following parameters:

License File Name: LicenseV3_9.ini

Main License File Password: password

Global Authorization Definition Password: globalpassword

Finger-Print Options Code: 1455235
(For reference only this Finger Print Option Code corresponds to setting: Hard Drive Model, Hard Drive Hardware Serial No., Windows Serial Number, Operating System Build Number, Operating System "Windows" Directory, Operating System "Temp" Directory, Machine Platform Type, MAC Address of Network Interface Card 1, User Name. )

 

---

 

C++ StartUp Example

// Note this example assumes you have deployed the Main License File to the host application directory.

char * MainLicenseFileName = {"LicenseV3_9.ini"};
char * MainLicenseFilePassword = {"password"};
char * GlobalAuthorizationCodePassword = {"globalpassword"};
int FingerPrintOptionsCode = 1455235;
long return_code;

CoClientProtector->StartUp(MainLicenseFileName, MainLicenseFilePassword, GlobalAuthorizationCodePassword, FingerPrintOptionsCode, &return_code );

 

---

 

VB StartUp Example

// Note this example assumes you have deployed the Main License File to the host application directory.

Dim return_code As Long

Call pCoClientProtector.StartUp("LicenseV3_9.ini", "password", "globalpassword", 1455235, return_code)