BWIInit – Initialise Bank Wizard core

BWIInit (h)

Use this to initialise the Bank Wizard core before running any validation or searches. During initialisation, the Licence Key and Database Table Files (DTFs) are checked and the DTFs are made available.

If any fatal conditions occur, then the initialisation has failed and Bank Wizard will not function. Bank Wizard can still function if error and warning conditions occur during initialisation.

By default, all licensed countries are initialised. Use BWISetRuntime with either BWI_R_INC_COUNTRY or BWI_R_EX_COUNTRY items to limit the countries initialised.

If the core is already initialised and no runtime parameters have been changed since the initialisation, then calling BWIInit again does not re-initialise the core.

Input parameter

h Initialisation handle created using BWICreateHandle. You MUST use BWIFree to free this after initialising the core and handling any initialisation conditions returned.

This function handles some errors differently from other functions, so do not re-use this handle. For example, not finding a specific country DTF during initialisation is an error, whereas not finding the table when the application is running, is a fatal error.

Conditions returned

Fatal Conditions
   
BWI_F_BADKEY BWI_F_DEPVER BWI_F_EXLIC
BWI_F_NOBWIMAIN BWI_F_NOINI BWI_F_NOLIC
BWI_F_NOMEM    
Error

 

 
Each of these errors is returned by country and means that country is not initialised. You can still use other countries, unless you get the fatal error BWI_F_NOINI.
BWI_E_EXLIC BWI_E_TABLE_MISSING  
Warning
   
BWI_W_30DAY