Functions |
| BOOL | BCAttachInstance (HINSTANCE hInstance) |
| | Attach library to given instance (Windows static library only). Required only for static library variants of TBarCode. Must be called as first function. -
Note:
-
Contact TEC-IT regarding the availability of TBarCode as static library
-
WINDOWS only. \param[in] hInstance Instance handle of process.
-
Return values:
-
| true
|
Initialization successful |
| false
|
Initialization not successful ----------------------------------------------------------------------------. |
|
| BOOL | BCAttach () |
| | Initializes TBarCode for further use (Windows static library only). Required only for static library variants of TBarCode (not for DLLs). Must be called as first function. -
Note:
-
Contact TEC-IT regarding the availability of TBarCode as static library
-
WINDOWS only.
-
Return values:
-
| true
|
Initialization successful |
| false
|
Initialization not successful ----------------------------------------------------------------------------. |
|
| BOOL | BCDetach () |
| | Detach library from process (Windows static library only). Required only for static library variants of TBarCode (not for DLLs). Must be called as last function. -
Note:
-
Contact TEC-IT regarding the availability of TBarCode as static library
-
WINDOWS only.
-
Return values:
-
| true
|
De-initialization successful |
| false
|
De-initialization not successful ----------------------------------------------------------------------------. |
|
| ERRCODE | BCInitLibraryA (LPCSTR szPath) |
| | Initializes TBarCode Library (UNIX and Windows CE only). Must be called after loading TBarCode library and before calling any other functions from TBarCode. -
Note:
-
UNIX only. \param[in] szPath Directory in which the TBarCode license files are to be searched.
TBarCode Library can be licensed per application using BCLicenseMe() or globally on a system. To license TBarCode globally a valid license file named 'license.ini' must be placed in the path specified with szPath.
The default location for 'license.ini' is '/usr/local/share/tbarcode11'.
-
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. ----------------------------------------------------------------------------. |
|
| ERRCODE | BCInitLibraryW (LPCWSTR szPath) |
| | Initializes TBarCode Library (UNIX and Windows CE only). Must be called after loading TBarCode library and before calling any other functions from TBarCode. -
Note:
-
UNIX only. \param[in] szPath Directory in which the TBarCode license files are to be searched.
TBarCode Library can be licensed per application using BCLicenseMe() or globally on a system. To license TBarCode globally a valid license file named 'license.ini' must be placed in the path specified with szPath.
The default location for 'license.ini' is '/usr/local/share/tbarcode11'.
-
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. ----------------------------------------------------------------------------. |
|
| ERRCODE | _BCInitLibraryT (LPCTSTR szPath) |
| | Initializes TBarCode Library (UNIX and Windows CE only). Must be called after loading TBarCode library and before calling any other functions from TBarCode. -
Note:
-
UNIX only. \param[in] szPath Directory in which the TBarCode license files are to be searched.
TBarCode Library can be licensed per application using BCLicenseMe() or globally on a system. To license TBarCode globally a valid license file named 'license.ini' must be placed in the path specified with szPath.
The default location for 'license.ini' is '/usr/local/share/tbarcode11'.
-
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. ----------------------------------------------------------------------------. |
|
| ERRCODE | BCDeInitLibrary () |
| | De-initializes TBarCode Library (UNIX and Windows CE only). Must be called before terminating the application or before unloading TBarCode Library. -
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. ----------------------------------------------------------------------------. |
|
| ERRCODE | BCAlloc (t_BarCode** ppBarCode) |
| | Allocates and initializes barcode structure. Must be called as first function before any other call using pBarCode. This function allocates and initializes the internal barcode structure to store all parameters. It sets the pointer that you pass to this function. For each barcode you want to use simultaneously, you have to call this function to get an appropriate handle (pBarCode). \param[in, out] ppBarCode Pointer to barcode structure. Only valid if return value is ErrOk (0) -
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. |
-
See also:
-
BCFree() ----------------------------------------------------------------------------.
|
| ERRCODE | BCClone (t_BarCode** ppBarCodeDest, const t_BarCode* pBarCodeSrc) |
| | Makes a clone of an existing bar code structure. Call this function if you need a deep copy of a bar code structure. You have to call BCFree on pBarCodeDest after using in order to free the allocated resources. \param[in, out] ppBarCodeDest Pointer to destination barcode structure. \param[in] pBarCodeSrc Pointer to source barcode structure. -
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. |
-
See also:
-
BCFree() ----------------------------------------------------------------------------.
|
| ERRCODE | BCFree (t_BarCode* pBarCode) |
| | Frees barcode structure. Must be called as last function and frees all resources used by pBarCode. The pointer pBarCode must not be used after this call. \param[in] pBarCode Pointer to barcode structure. -
See also:
-
BCAlloc()
-
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. ----------------------------------------------------------------------------. |
|
| ERRCODE | BCLicenseMeA (LPCSTR lpszLicensee, e_licKind eKindOfLicense, DWORD dwNoOfLicenses, LPCSTR lpszKey, e_licProduct eProductID) |
| | License TBarCode. Licenses the library with the license key provided by TEC-IT. All demo-mode restrictions are removed. Licensing must take place before you draw a barcode or generate a barcode image file. After licensing the library will stay in licensed mode until it is unloaded from memory. Call this function and pass in the license key you have got after purchasing your license. You receive the license key from TEC-IT Datenverarbeitung GmbH (you can order through https://www.tec-it.com/order). The license kind, the number of licenses and the licensee string have to be passed in exactly as given, they are checked against the license key.
-
Note:
-
For Windows only: - If the license key starts with "Mem: xxxxxxxx" the product is licensed until TBarCode will be unloaded from memory. - If the license key received by TEC-IT looks like "HKCU:xxxxxxxx" the product is licensed in the section "HKEY Current User" of the Windows registry. - If the license key received by TEC-IT looks like "xxxxxxxx" or "HKLM:xxxxxxxx" the product is licensed within the section "HK Local Machine" of the Windows Registry (this is the default).
-
Alternative licensing method: TEC-IT provides the possibility to license the product via an .ini-file (please contact TEC-IT for details). \param[in] lpszLicensee String containing the name of the Licensee. Provided by TEC-IT after ordering. \param[in] eKindOfLicense The type of the license. Provided by TEC-IT after ordering. \param[in] dwNoOfLicenses The number of available licenses. Provided by TEC-IT after ordering. \param[in] lpszKey String containing the license key Provided by TEC-IT after ordering. \param[in] eProductID The type of the licensed product variant (1D or 2D). The Product ID indicates which barcode types will be licensed. One-dimensional (1D or linear barcodes) (1D = Code128, UPC, EAN, Code39, ...) or two-dimensional (2D) barcodes (PDF417, MaxiCode, Data Matrix, ...).
-
Return values:
-
| ERRCODE
|
Returns always ErrOk (0) - even if license key is invalid ----------------------------------------------------------------------------. |
|
| ERRCODE | BCLicenseMeW (LPCWSTR lpszLicensee, e_licKind eKindOfLicense, DWORD dwNoOfLicenses, LPCWSTR lpszKey, e_licProduct eProductID) |
| | License TBarCode. Licenses the library with the license key provided by TEC-IT. All demo-mode restrictions are removed. Licensing must take place before you draw a barcode or generate a barcode image file. After licensing the library will stay in licensed mode until it is unloaded from memory. Call this function and pass in the license key you have got after purchasing your license. You receive the license key from TEC-IT Datenverarbeitung GmbH (you can order through https://www.tec-it.com/order). The license kind, the number of licenses and the licensee string have to be passed in exactly as given, they are checked against the license key.
-
Note:
-
For Windows only: - If the license key starts with "Mem: xxxxxxxx" the product is licensed until TBarCode will be unloaded from memory. - If the license key received by TEC-IT looks like "HKCU:xxxxxxxx" the product is licensed in the section "HKEY Current User" of the Windows registry. - If the license key received by TEC-IT looks like "xxxxxxxx" or "HKLM:xxxxxxxx" the product is licensed within the section "HK Local Machine" of the Windows Registry (this is the default).
-
Alternative licensing method: TEC-IT provides the possibility to license the product via an .ini-file (please contact TEC-IT for details). \param[in] lpszLicensee String containing the name of the Licensee. Provided by TEC-IT after ordering. \param[in] eKindOfLicense The type of the license. Provided by TEC-IT after ordering. \param[in] dwNoOfLicenses The number of available licenses. Provided by TEC-IT after ordering. \param[in] lpszKey String containing the license key Provided by TEC-IT after ordering. \param[in] eProductID The type of the licensed product variant (1D or 2D). The Product ID indicates which barcode types will be licensed. One-dimensional (1D or linear barcodes) (1D = Code128, UPC, EAN, Code39, ...) or two-dimensional (2D) barcodes (PDF417, MaxiCode, Data Matrix, ...).
-
Return values:
-
| ERRCODE
|
Returns always ErrOk (0) - even if license key is invalid ----------------------------------------------------------------------------. |
|
| ERRCODE | BCCreate (t_BarCode* pBarCode) |
| | Creates the internal barcode representation. Creates the internal barcode representation depending on all barcode parameters previously set. After this call the barcode is ready for drawing or saving (e.g. with BCDraw()). Do not change barcode parameters or input data after this call. -
See also:
-
BCDraw(), BCSaveImage()
-
Note:
-
This function call is a must! \param[in] pBarCode Pointer to barcode structure.
-
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. ----------------------------------------------------------------------------. |
|
Allocates and initializes barcode structure. Must be called as first function before any other call using pBarCode. This function allocates and initializes the internal barcode structure to store all parameters. It sets the pointer that you pass to this function. For each barcode you want to use simultaneously, you have to call this function to get an appropriate handle (pBarCode). \param[in, out] ppBarCode Pointer to barcode structure. Only valid if return value is ErrOk (0)
-
Return values:
-
| ERRCODE
|
ErrOk (0) in case of success. Non-zero if error occurred. |
-
See also:
-
BCFree() ----------------------------------------------------------------------------.
License TBarCode. Licenses the library with the license key provided by TEC-IT. All demo-mode restrictions are removed. Licensing must take place before you draw a barcode or generate a barcode image file. After licensing the library will stay in licensed mode until it is unloaded from memory. Call this function and pass in the license key you have got after purchasing your license. You receive the license key from TEC-IT Datenverarbeitung GmbH (you can order through https://www.tec-it.com/order). The license kind, the number of licenses and the licensee string have to be passed in exactly as given, they are checked against the license key.
-
Note:
-
For Windows only: - If the license key starts with "Mem: xxxxxxxx" the product is licensed until TBarCode will be unloaded from memory. - If the license key received by TEC-IT looks like "HKCU:xxxxxxxx" the product is licensed in the section "HKEY Current User" of the Windows registry. - If the license key received by TEC-IT looks like "xxxxxxxx" or "HKLM:xxxxxxxx" the product is licensed within the section "HK Local Machine" of the Windows Registry (this is the default).
-
Alternative licensing method: TEC-IT provides the possibility to license the product via an .ini-file (please contact TEC-IT for details). \param[in] lpszLicensee String containing the name of the Licensee. Provided by TEC-IT after ordering. \param[in] eKindOfLicense The type of the license. Provided by TEC-IT after ordering. \param[in] dwNoOfLicenses The number of available licenses. Provided by TEC-IT after ordering. \param[in] lpszKey String containing the license key Provided by TEC-IT after ordering. \param[in] eProductID The type of the licensed product variant (1D or 2D). The Product ID indicates which barcode types will be licensed. One-dimensional (1D or linear barcodes) (1D = Code128, UPC, EAN, Code39, ...) or two-dimensional (2D) barcodes (PDF417, MaxiCode, Data Matrix, ...).
-
Return values:
-
| ERRCODE
|
Returns always ErrOk (0) - even if license key is invalid ----------------------------------------------------------------------------. |
License TBarCode. Licenses the library with the license key provided by TEC-IT. All demo-mode restrictions are removed. Licensing must take place before you draw a barcode or generate a barcode image file. After licensing the library will stay in licensed mode until it is unloaded from memory. Call this function and pass in the license key you have got after purchasing your license. You receive the license key from TEC-IT Datenverarbeitung GmbH (you can order through https://www.tec-it.com/order). The license kind, the number of licenses and the licensee string have to be passed in exactly as given, they are checked against the license key.
-
Note:
-
For Windows only: - If the license key starts with "Mem: xxxxxxxx" the product is licensed until TBarCode will be unloaded from memory. - If the license key received by TEC-IT looks like "HKCU:xxxxxxxx" the product is licensed in the section "HKEY Current User" of the Windows registry. - If the license key received by TEC-IT looks like "xxxxxxxx" or "HKLM:xxxxxxxx" the product is licensed within the section "HK Local Machine" of the Windows Registry (this is the default).
-
Alternative licensing method: TEC-IT provides the possibility to license the product via an .ini-file (please contact TEC-IT for details). \param[in] lpszLicensee String containing the name of the Licensee. Provided by TEC-IT after ordering. \param[in] eKindOfLicense The type of the license. Provided by TEC-IT after ordering. \param[in] dwNoOfLicenses The number of available licenses. Provided by TEC-IT after ordering. \param[in] lpszKey String containing the license key Provided by TEC-IT after ordering. \param[in] eProductID The type of the licensed product variant (1D or 2D). The Product ID indicates which barcode types will be licensed. One-dimensional (1D or linear barcodes) (1D = Code128, UPC, EAN, Code39, ...) or two-dimensional (2D) barcodes (PDF417, MaxiCode, Data Matrix, ...).
-
Return values:
-
| ERRCODE
|
Returns always ErrOk (0) - even if license key is invalid ----------------------------------------------------------------------------. |
