C++ API Reference - CBarcodeReader License Methods

Method	Description
`InitLicense`	Read product key and activate the SDK.
`InitLicenseFromServer`	Initialize license and connect to the specified server for online verification.
`InitLicenseFromLicenseContent`	Initialize license from the license content on client machine for offline verification.
`OutputLicenseToString`	Output the license content to a string from the license server.
`OutputLicenseToStringPtr`	Output the license content to a string from the license server.
`FreeLicenseString`	Free memory allocated for the license string.

InitLicense

Read product key and activate the SDK.

int CBarcodeReader::InitLicense (const char* pLicense)	

Parameters

[in] pLicense The product keys.

Return value

Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

Code Snippet

CBarcodeReader* reader = new CBarcodeReader();
reader->InitLicense("t0260NwAAAHV***************");
delete reader;

InitLicenseFromServer

Initialize the license and connect to the specified server for online verification.

int CBarcodeReader::InitLicenseFromServer (const char* pLicenseServer, const char* pLicenseKey)

Parameters

[in] pLicenseServer The URL of the license server.
[in] pLicenseKeyThe license key.

Return value

Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

InitLicenseFromLicenseContent

Initialize barcode reader license from the license content on the client machine for offline verification.

int CBarcodeReader::InitLicenseFromLicenseContent (const char* pLicenseKey, const char* pLicenseContent)	

Parameters

[in] pLicenseKey The license key.
[in] pLicenseContent An encrypted string representing the license content (quota, expiration date, barcode type, etc.) obtained from the method OutputLicenseToString.

Return value

Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

OutputLicenseToString

Output the license content as an encrypted string from the license server to be used for offline license verification.

int CBarcodeReader::OutputLicenseToString (char content[], const int contentLen)

Parameters

[in,out] content The output string which stores the content of license.
[in] contentLen The length of output string. The recommended length is 512 per license key.

Return value

Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

Remark

InitLicenseFromServer has to be successfully called before calling this method.

OutputLicenseToStringPtr

Output the license content as an encrypted string from the license server to be used for offline license verification.

int CBarcodeReader::OutputLicenseToStringPtr (char** content)

Parameters

[in,out] content The output string which stores the content of license.

Return value

Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

Remarks

InitLicenseFromServer has to be successfully called before calling this method.

FreeLicenseString

Free memory allocated for the license string.

void CBarcodeReader::FreeLicenseString (char** content)

Parameters

[in] content The output string which stores the content of license.

Remark

OutputLicenseToStringPtr has to be successfully called before calling this method.