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. |
InitLTSConnectionParameters |
Initializes a DM_LTSConnectionParameters struct with default values. |
InitLicenseFromLTS |
Initializes the barcode reader license and connects to the specified server for online verification. |
InitLicense
Read product key and activate the SDK.
int dynamsoft::dbr::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 dynamsoft::dbr::CBarcodeReader::InitLicenseFromServer (const char* pLicenseServer, const char* pLicenseKey)
Parameters
[in] pLicenseServer
The URL of the license server.
[in] pLicenseKey
The 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 dynamsoft::dbr::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 dynamsoft::dbr::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 dynamsoft::dbr::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 dynamsoft::dbr::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.
InitLTSConnectionParameters
Initializes a DM_LTSConnectionParameters struct with default values.
static int dynamsoft::dbr::CBarcodeReader::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 GetErrorString
to get detailed error message.
Code Snippet
DMLTSConnectionParameters paramters;
dynamsoft::dbr::CBarcodeReader::InitLTSConnectionParameters(¶mters);
paramters.handshakeCode = "Your handshake code";
dynamsoft::dbr::CBarcodeReader::InitLicenseFromLTS(¶mters);
InitLicenseFromLTS
Initializes the barcode reader license and connects to the specified server for online verification.
static int dynamsoft::dbr::CBarcodeReader::InitLicenseFromLTS(DM_LTSConnectionParameters *pLTSConnectionParameters, char errorMsgBuffer[] = NULL, const int errorMsgBufferLen = 0)
Parameters
[in] pLTSConnectionParameters
The struct DM_LTSConnectionParameters
with customized settings.
[in, out] errorMsgBuffer
Optional The buffer is allocated by the caller and the recommended length is 256. The error message will be copied to the buffer.
[in] errorMsgBufferLen
Optional The length of the allocated buffer.
Return value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString
to get detailed error message.
Code Snippet
DMLTSConnectionParameters paramters;
dynamsoft::dbr::CBarcodeReader::InitLTSConnectionParameters(¶mters);
paramters.handshakeCode = "Your handshake code";
dynamsoft::dbr::CBarcodeReader::InitLicenseFromLTS(¶mters);