SoftwareShield System Feature Guide > Implementation Support > Programming Notes

Programming Notes


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.

Related Topics

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)