本节列出了用于与 DBTools 库交换信息的结构。这些结构按字母顺序列出。除 a_remote_sql 结构以外，所有这些结构都在 dbtools.h 中定义。a_remote_sql 结构在 dbrmt.h 中定义。

许多结构元素与相应实用程序上的命令行选项相对应。例如，有几个结构具有名为 quiet 的成员，它们可采用值 0 或 1。该成员与由许多实用程序使用的 quiet 操作 (-q) 选项相对应。

本文件中定义的数据结构可与其适用的 SQL Anywhere 主版本的 DBTools API 结合使用。例如，使用 10.0.0 版 dbtools.h 文件构建的应用程序将不能访问 dbtool9.dll 或 dbtool11.dll。

在一个主版本中，对结构所做的任何更改必须满足一定的条件，即，确保通过同一主版本下的 dbtools.h 文件的较低或较高版本构建的应用程序能够正常工作。使用较早版本构建的应用程序将无权访问新的字段，因此，DBTools 将提供一些缺省值，以便执行与较早版本中的行为相同的行为。通常，这意味着主版本中的新增字段将出现在结构末尾。

通过同一主版本下的较高版本构建的应用程序的行为将取决于结构的“版本”字段值。如果提供的版本号对应于较早的版本，则应用程序可调用 DBTools DLL 的较早版本，就如同该应用程序是使用此版本的 dbtools.h 构建的一样。如果提供的版本为当前版本，则如果使用 DBTools DLL 的较早版本将导致错误。

有关版本号的定义，请参见 dbtlvers.h。