The SetPrependFingerPrintString function may be called immediately before the StartUp function is called to add your own FingerPrint data to the list of data collected by the FingerPrint sub-system before the actual FingerPrint for the host machine is calculated.

Syntax

HRESULT SetPrependFingerPrintString ( BSTR PrependedFingerPrintString );

Parameters

PrependedFingerPrintString 

[IN] Wide character, case-sensitive string of any length. Must contain any and all programmer defined input to be used as part of the internal data parsed by the FingerPrint sub-system before the FingerPrint is actually calculated.

Remarks

If you decide to use your own (programmer defined) FingerPrint algorithm(s) to gather data from the user, environment, network, machine or other source - use this function to input the data you collect. You must input this data only once using this function and it must be input immediately before the StartUp function is called.  

The string input is case-sensitive of arbitrary length.  Passing strings to this function which are not perfectly identical will result in a different FingerPrint being calculated for the host machine.

The ClientProtector will pre-pend this string to the list of other information gathered from the host system for use as input data to the hashing algorithm that creates the FingerPrint used throughout the system.  In other words, if you create your license and set it to use no fingerprint at all (FingerPrint code of 0), but you choose to invoke this function immediately prior to invoking StartUp, then the FingerPrints created in Authorization Request Codes and checked against in input Activation Codes will be solely based upon this string.   

Using this function does not preclude you from using additional fingerprint flags.  You may also effectively hardware lock using the standard set of 23 flags provided which allow you to make an Activation Code you generate specific to a single machine (as well as any string you pass).  

The Fingerprint mechanism will assemble all the information it requires as input to the hash algorithm.  This includes the string passed to this function.  It uses this collection of information to create the FingerPrint. If you choose to use none of the standard fingerprint flags (fingerprint code of 0) then the fingerprint will effectively consist of only this string.   

Return Value

As with all COM function calls they return an HRESULT. HRESULT is a data type that is a 32-bit error or warning code. Check your compilers documentation for information on interpreting the HRESULT value.

Function Information

Exposed By Interface:	"ISSCProtector"
Exposed In COM Server Binaries:	"SSCProt.dll" and "SSCProtD.dll"