Before using any other DBTools functions, you must call DBToolsInit. When you are finished using the DBTools library, you must call DBToolsFini.
The primary purpose of the DBToolsInit and DBToolsFini functions is to allow the DBTools library to load the SQL Anywhere message library. The messages library contains localized versions of all error messages and prompts that DBTools uses internally. If DBToolsFini is not called, the reference count of the messages library is not decremented and it will not be unloaded, so be careful to ensure there is a matched pair of DBToolsInit/DBToolsFini calls.
The following code fragment illustrates how to initialize and clean up DBTools:
// 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 ); |
Discuss this page in DocCommentXchange.
|
Copyright © 2010, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.0 |