Dev Center
Table of contents

C API Reference - License Methods

Method Description
DBR_InitLicense Read product key and activate the SDK.
DBR_InitLicenseFromServer Initialize license and connect to the specified server for online verification.
DBR_InitLicenseFromLicenseContent Initialize license from the license content on client machine for offline verification.
DBR_OutputLicenseToString Output the license content to a string from the license server.
DBR_OutputLicenseToStringPtr Output the license content to a string from the license server.
DBR_FreeLicenseString Free memory allocated for the license string.
DBR_InitLTSConnectionParameters Initializes a DM_LTSConnectionParameters struct with default values.
DBR_InitLicenseFromLTS Initializes the barcode reader license and connects to the specified server for online verification.

DBR_InitLicense

Read product key and activate the SDK.

DBR_API int DBR_InitLicense (void* barcodeReader, const char* pLicense)

Parameters

[in] barcodeReader Handle of the barcode reader instance.
[in] pLicense The product keys.

Return value

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

Code Snippet

void* barcodeReader = DBR_CreateInstance();
DBR_InitLicense(barcodeReader, "t0260NwAAAHV***************");
DBR_DestroyInstance(barcodeReader);

DBR_InitLicenseFromServer

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

DBR_API int DBR_InitLicenseFromServer (void* barcodeReader, const char* pLicenseServer, const char* pLicenseKey)

Parameters

[in] barcodeReader Handle of the barcode reader instance.
[in] pLicenseServer The name/IP of the license server.
[in] pLicenseKey The license key.

Return value

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

DBR_InitLicenseFromLicenseContent

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

DBR_API int DBR_InitLicenseFromLicenseContent (void* barcodeReader, const char* pLicenseKey, const char* pLicenseContent)	

Parameters

[in] barcodeReader Handle of the barcode reader instance.
[in] pLicenseKey The license key.
[in] pLicenseContent An encrypted string representing the license content (quota, expiration date, barcode type, etc.) obtained from the method DBR_OutputLicenseToString.

Return value

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

DBR_OutputLicenseToString

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

DBR_API int DBR_OutputLicenseToString (void* barcodeReader, char content[], int contentLen)

Parameters

[in] barcodeReader Handle of the barcode reader instance.
[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 DBR_GetErrorString to get detailed error message.

Remark

DBR_InitLicenseFromServer has to be successfully called before calling this method.

DBR_OutputLicenseToStringPtr

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

DBR_API int DBR_OutputLicenseToStringPtr (void* barcodeReader, char** content)

Parameters

[in] barcodeReader Handle of the barcode reader instance.
[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 DBR_GetErrorString to get detailed error message.

Remark

DBR_InitLicenseFromServer has to be successfully called before calling this method.

DBR_FreeLicenseString

Free memory allocated for the license string.

DBR_API void DBR_FreeLicenseString (char** content)

Parameters

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

Remark

DBR_OutputLicenseToStringPtr has to be successfully called before calling this method.

DBR_InitLTSConnectionParameters

Initializes a DM_LTSConnectionParameters struct with default values.

DBR_API int DBR_InitLTSConnectionParameters (DM_LTSConnectionParameters *pLTSConnectionParameters)

Parameters

[in, out] pLTSConnectionParameters The struct of DM_LTSConnectionParameters.

Return value

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

Code Snippet

char errorBuf[512];
DMLTSConnectionParameters paramters;
DBR_InitLTSConnectionParameters(&paramters);
paramters.handshakeCode = "Your handshake code";
DBR_InitLicenseFromLTS(&paramters, errorBuf, 512);

DBR_InitLicenseFromLTS

Initializes the barcode reader license and connects to the specified server for online verification.

DBR_API int DBR_InitLicenseFromLTS(DM_LTSConnectionParameters *pLTSConnectionParameters, char errorMsgBuffer[], const int errorMsgBufferLen)

Parameters

[in] pLTSConnectionParameters The struct DM_LTSConnectionParameters with customized settings.
[in, out] errorMsgBuffer The buffer is allocated by caller and the recommended length is 256. The error message will be copied to the buffer.
[in] errorMsgBufferLen The length of allocated buffer.

Return value

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

Code Snippet

char errorBuf[512];
DMLTSConnectionParameters paramters;
DBR_InitLTSConnectionParameters(&paramters);
paramters.handshakeCode = "Your handshake code";
DBR_InitLicenseFromLTS(&paramters, errorBuf, 512);

This page is compatible for:

Version 7.5.0

Is this page helpful?

YesYes NoNo

In this article:

version 8.2.0

  • Latest version
  • Version 10.x
    • Version 10.2.10
    • Version 10.2.0
    • Version 10.0.20
    • Version 10.0.10
    • Version 10.0.0
  • Version 9.x
    • Version 9.6.40
    • Version 9.6.30
    • Version 9.6.20
    • Version 9.6.10
    • Version 9.6.0
    • Version 9.4.0
    • Version 9.2.0
    • Version 9.0.0
  • Version 8.x
    • Version 8.8.0
    • Version 8.6.0
    • Version 8.4.0
    • Version 8.2.0
    • Version 8.1.2
    • Version 8.1.0
    • Version 8.0.0
  • Version 7.x
    • Version 7.6.0
    • Version 7.5.0
Change +