The InputActivationCodeSN function causes the ClientProtector to parse the Activation Code passed in and attempts to activate it against the currently loaded license - possibly changing the license state and adding the provided Serial Number to the activated Authorization Definition.

Syntax

HRESULT InputActivationCodeSN ( BSTR ActivationCode, BSTR SerialNumber,  long * return_code ) ;

Parameters

ActivationCode

[IN] This is the Activation Code that your application has collected (probably from the user) and is attempting to activate.

 

SerialNumber

[IN] This is the Serial Number you wish to store in the Authorization Definition that corresponds to the Activation Code. The Serial Number is only stored if the Activation Code is successfully activated.

Remarks

Note: This function is illustrated in the SoftwareShield Flowcharts - (see flow chart #5).

The InputActivationCodeSN function takes as input an Activation Code from your application (probably collected from the user) and attempts to activate it. If the activation is successful, the provided Serial Number is stored in the activated Authorization Definition.

Call this function when your application has collected an Activation Code and a Serial Number from the user (or other source) and wishes to activate it in order to change the state of the license in some way. Use this function when doing a "phone-in-activation" for the user.

Note that this function does not expect a passed Activation Code to correspond to any specific Authorization Definition in the license.  It may correspond to any definition.   

The provided Serial Number is not validated against the CheckPoint server, nor is it validated for its format or content.  This function is provided to specifically allow you to do a phone-in activation where no CheckPoint server connectivity is expected.  

If you instead wish to validate a Serial Number against the CheckPoint Server live through HTTP, call AutoActivateSerialNumber or do this synchronously during the scope of your StartUp call inside the OnPrepareAutoActivate event.

The function will attempt to validate and activate the code input. If the code is not valid for any reason, the return_code parameter will return holding some "false" value.  Please refer to the SoftwareShield ClientProtector Control Flow Charts to determine possible false return codes.

If the code was successfully validated and activated the return_code parameter will (possibly) return holding some true value. Please refer to the SoftwareShield ClientProtector Control Flow Charts to determine possible return codes.  Likewise, it will activate the associated Authorization Definition and store the provided Serial Number inside it.

Note that your application must be prepared for all possible values of RETURNCODES.

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"