Bevor Sie andere DBTools-Funktionen verwenden, müssen Sie DBToolsInit aufrufen. Wenn Sie die DBTools-Bibliothek nicht mehr verwenden, müssen Sie DBToolsFini aufrufen.

Die Funktionen DBToolsInit und DBToolsFini bezwecken hauptsächlich, der DBTools-Bibliothek das Laden der SQL Anywhere-Meldungsbibliothek zu ermöglichen. Die Meldungsbibliothek enthält lokalisierte Versionen aller Fehlermeldungen und Eingabeaufforderungen, die DBTools intern verwendet. Wenn DBToolsFini nicht aufgerufen wird, kann die Referenznummer der Meldungsbibliothek nicht heruntergezählt werden, sodass diese Meldungsbibliothek nicht entladen wird. Achten Sie daher immer darauf, dass zu jedem Aufruf von DBToolsInit als Gegenstück DBToolsFini aufgerufen wird.

Im folgenden Programmcodebeispiel wird gezeigt, wie DBTools aufgerufen und wieder bereinigt werden:

// Declarations
a_dbtools_info  info;
short           ret;

//Initialize the a_dbtools_info structure
memset( &info, 0, sizeof( a_dbtools_info) );
info.errorrtn = (MSG_CALLBACK)MyErrorRtn;

// initialize the DBTools library
ret = DBToolsInit( &info );
if( ret != EXIT_OKAY ) {
    // library initialization failed
    ...
}
// call some DBTools routines ...
...
// finalize the DBTools library
DBToolsFini( &info );