initialize-and-destroy.md

layout	title	description	keywords	needAutoGenerateSidebar	permalink
default-layout	Initialize and Destroy Functions - Dynamsoft Barcode Reader SDK C Edition API Reference	This page shows Initialize and Destroy functions of Dynamsoft Barcode Reader SDK C Edition.	DBR_CreateInstance, DBR_DestroyInstance, initialize and destroy functions, api reference, c	true	/programming/c/api-reference/methods/initialize-and-destroy.html

Initialize and Destroy Functions

Function	Description
DBR_CreateInstance	Creates an instance of Dynamsoft Barcode Reader.
DBR_DestroyInstance	Destroys the instance of Dynamsoft Barcode Reader.
DBR_GetInstance	Creates an instance of Dynamsoft Barcode Reader.
DBR_RecycleInstance	Destroys an instance of Dynamsoft Barcode Reader.

DBR_CreateInstance

Creates an instance of Dynamsoft Barcode Reader.

DBR_API void* DBR_CreateInstance ()	

Return Value

Returns an instance of Dynamsoft Barcode Reader. If failed, returns NULL.

Code Snippet

char errorBuf[512];
DBR_InitLicense("YOUR-LICENSE-KEY", errorBuf, 512);
void* barcodeReader = DBR_CreateInstance();
DBR_DestroyInstance(barcodeReader);

DBR_DestroyInstance

Destroys an instance of Dynamsoft Barcode Reader.

DBR_API void DBR_DestroyInstance (void* barcodeReader)	

Parameters

[in] barcodeReader Handle of the barcode reader instance.

Code Snippet

char errorBuf[512];
DBR_InitLicense("YOUR-LICENSE-KEY", errorBuf, 512);
void* barcodeReader = DBR_CreateInstance();
DBR_DestroyInstance(barcodeReader);

DBR_GetInstance

Creates an instance of Dynamsoft Barcode Reader.

DBR_API void* DBR_GetInstance()

Return Value
Returns an instance of Dynamsoft Barcode Reader. If failed, returns NULL.

Code Snippet

//Make sure DBR_InitLicense have been called somewhere before DBR_GetInstance
void* dbr = DBR_GetInstance();
// If no instance is available right away, the application will wait until one becomes available
if(dbr != NULL)
{
    // Add your code here to call decoding method, process barcode results and so on
    // ...
    DBR_RecycleInstance(dbr);
}

DBR_RecycleInstance

Destroys an instance of Dynamsoft Barcode Reader.

DBR_API void DBR_RecycleInstance (void* barcodeReader)

Parameters

[in] barcodeReader Handle of a Dynamsoft Barcode Reader instance running on concurrent instance mode.

Code Snippet

//Make sure DBR_InitLicense have been called somewhere before DBR_GetInstance
void* dbr = DBR_GetInstance();
// If no instance is available right away, the application will wait until one becomes available
if(dbr != NULL)
{
    // Add your code here to call decoding method, process barcode results and so on
    // ...
    DBR_RecycleInstance(dbr);
}