Version Numbers and Compatibility

Each structure has a member that indicates the version number. You should set the version field to the version number of the DBTools library that your application was developed against before calling any DBTools function. The current version of the DBTools library is defined when you include the dbtools.h header file.

The following example assigns the current version to an instance of the a_backup_db structure:

backup_info.version = DB_TOOLS_VERSION_NUMBER;

The version number allows your application to continue working with newer versions of the DBTools library. The DBTools functions use the version number supplied by your application to allow the application to work, even if new members have been added to the DBTools structure.

When any of the DBTools structures are updated, or when a newer version of the software is released, the version number is augmented. If you use DB_TOOLS_VERSION_NUMBER and you rebuild your application with a new version of the DBTools header file, then you must deploy a new version of the DBTools library.