SoftwareShield ClientProtector COM Component > ClientProtector (SSCProtector) Reference > GetHostMachineFingerPrints

GetHostMachineFingerPrints


The GetHostMachineFingerPrints function retrieves the machine FingerPrint values computed for the host machine, using the set of FingerPrint flags, and any prepended FingerPrint string from the currently loaded license.

Syntax

HRESULT GetHostMachineFingerPrints (

long * EmbedLengthFingerPrint,

BSTR * FullLengthFingerPrintStr  

);

Parameters

EmbedLengthFingerPrint

[OUT]  This is (a pointer to) a numeric value that returns holding the embedded length FingerPrint value for the host machine, computed using the set of FingerPrint flags and any prepended FingerPrint string from the currently loaded license. This value is maximum 26 bits.
 

FullLengthFingerPrintStr

[OUT] This is (a pointer to) a wide character string that returns holding the full-length FingerPrint value for the host machine, computed using the set of FingerPrint flags and any prepended FingerPrint string from the currently loaded license. This is returned as a 256-bit value as a hexadecimal string.

Remarks

The GetHostMachineFingerPrints function retrieves the host machines FingerPrint computed for the host machine, using the set of FingerPrint flags, and any prepended FingerPrint string from the currently loaded license.

These values may be used by the developer to uniquely identify a particular machine for any other arbitrary purpose that may arise.

See FingerPrint Viewing for more information about the differences and meanings of the two types of FingerPrints.

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"

Related Topics