通过

行为更改

  • 项目

行为更改指的是接口的语法保持不变，但语义已更改。 由于这些更改，ODBC 2.x 使用的功能与 ODBC 3.x 中使用的相同功能，行为会有所不同。

根据 SQL_ATTR_ODBC_VERSION 环境属性确定应用程序是表现出 ODBC 2.x 行为还是 ODBC 3.x 行为。 此 32 位值设置为 SQL_OV_ODBC2 时会表现出 ODBC 2.x 行为，设置为 SQL_OV_ODBC3 则表现出 ODBC 3.x 行为。

SQL_ATTR_ODBC_VERSION 环境属性是通过调用 SQLSetEnvAttr 设置的。 在应用程序调用 SQLAllocHandle 以分配环境句柄后，必须立即调用 SQLSetEnvAttr 来设置其所表现的行为。 （因此，有一个新的环境状态可用来描述已分配但无版本状态的环境句柄。）有关详细信息，请参阅附录 B：ODBC 状态转换表。

应用程序会声明其使用 SQL_ATTR_ODBC_VERSION 环境属性所表现出的行为，但该属性对应用程序是连接 ODBC 2.x 还是 ODBC 3.x 没有影响。 ODBC 3.x 应用程序可以连接到 ODBC 2.x 或 3.x 驱动程序，无论环境属性的设置如何。

ODBC 3.x 应用程序不应调用 SQLAllocEnv。 因此，如果驱动程序管理器收到对 SQLAllocEnv 的调用，则会将该应用程序识别为ODBC 2.x 应用程序。

SQL_ATTR_ODBC_VERSION 属性会影响 ODBC 3.x 驱动程序行为的三个不同的方面：

  • SQLSTATEs

  • 日期、时间和时间戳的数据类型

  • SQLTables 中的 CatalogName 参数接受 ODBC 3.x 中的搜索模式，但不接受 ODBC 2.x 中的搜索模式

SQL_ATTR_ODBC_VERSION 环境属性的设置不会影响 SQLSetParam 或 SQLBindParam。 SQLColAttribute 也不受此位的影响。 尽管 SQLColAttribute 会返回受 ODBC 版本（日期类型、精度、小数位数和长度）影响的属性，但预期行为由 FieldIdentifier 参数的值确定。 当 FieldIdentifier 等于 SQL_DESC_TYPE 时，SQLColAttribute 返回日期、时间和时间戳的 ODBC 3.x 代码；当 FieldIdentifier 等于 SQL_COLUMN_TYPE 时，SQLColAttribute 返回日期、时间和时间戳的 ODBC 2.x 代码。

本部分包含以下主题。