The ForceDeactivate function deactivates the currently loaded license.  ForceDeactivate is useful when you want to immediately render the license deactivated with no prompting to the user and no confirmation code.

Note this is different than "Checking-In" a Serial Number which may deactivate an aspect of a license - not the entire thing.

Syntax

HRESULT ForceDeactivate ( long * return_code );

Parameters

return_code

[OUT] This is (a pointer to) a numeric value that returns with a RETURNCODE that identifies the outcome of the operation.

Remarks

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

Use ForceDeactivate only if you want to immediately render the license useless.  

When ForceDeactivate is called, if the license has not been initialized successfully with a call to StartUp, the function will return with return_code holding FALSE_LICENSE_NOT_INITIALIZED.

Otherwise, the return_code parameter will return holding FALSE_LICENSE_DEACTIVATED confirming that the license has indeed been deactivated.   

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"