驱动程序可以为以下项分配特定于驱动程序的值:
SQL 数据类型指示器 用于 SQLBindParameter 中的 ParameterType 以及 SQLGetTypeInfo 中的 DataType,由 SQLColAttribute、SQLColumns、SQLDescribeCol、SQLGetTypeInfo、SQLDescribeParam、SQLProcedureColumns 和 SQLSpecialColumns 返回。
描述符字段这些在 SQLColAttribute、SQLGetDescField 和 SQLSetDescField 中的 FieldIdentifier 中使用。
诊断字段 在 SQLGetDiagField 和 SQLGetDiagRec 中的 DiagIdentifier 中使用。
信息类型这些在 SQLGetInfo 中的 InfoType 中使用。
连接和语句属性这些属性用于 SQLGetConnectAttr、SQLGetStmtAttr、SQLSetConnectAttr 和 SQLSetStmtAttr 中的属性。
对于每个项,有两组值:保留供 ODBC 使用的值,以及驱动程序保留的值。 在实现特定于驱动程序的值之前,驱动程序编写器必须从 Open Group 请求每个特定于驱动程序的类型、字段或属性的值。 对于新的驱动程序开发,请使用下表中所述的范围。 如果使用的未知值不在下面所述的范围内,ODBC 3.8 驱动程序管理器将不会生成错误。 但是,如果收到不在范围内的未知值,则更高版本的驱动程序管理器可能会生成错误。
将这些值中的任何一个传递给 ODBC 函数时,驱动程序必须检查该值是否有效。 驱动程序返回 SQLSTATE HYC00(可选功能未实现)用于适用于其他驱动程序的驱动程序特定值。
从 ODBC 3.8 开始,驱动程序编写器可以在保留范围内分配特定于驱动程序的属性。
注释
ODBC 3.8 驱动程序管理器既不验证也不强制实施这些范围以实现向后兼容性。 但是,驱动程序管理器的未来版本可能会强制执行它们。
| 属性类型 | ODBC 数据类型 | 驱动程序特定的范围基准 | 驱动程序特定的范围限制 | 用于驱动程序特定值范围基数的 ODBC 常量 |
|---|---|---|---|---|
| SQL 数据类型指示器 | SQLSMALLINT | 0x4000 | 0x7FFF | SQL_DRIVER_SQL_TYPE_BASE |
| 描述符字段 | SQLSMALLINT | 0x4000 | 0x7FFF | SQL_DRIVER_DESCRIPTOR_BASE |
| 诊断字段 | SQLSMALLINT | 0x4000 | 0x7FFF | SQL_DRIVER_DIAGNOSTIC_BASE |
| 信息类型 | SQLUSMALLINT | 0x4000 | 0x7FFF | SQL_DRIVER_INFO_TYPE_BASE |
| 连接属性 | SQLINTEGER | 0x00004000 | 0x00007FFF | SQL_DRIVER_CONNECT_ATTR_BASE |
| 语句属性 | SQLINTEGER | 0x00004000 | 0x00007FFF | SQL_DRIVER_STATEMENT_ATTR_BASE |
注释
驱动程序文档中必须介绍特定于驱动程序的数据类型、描述符字段、诊断字段、信息类型、语句属性和连接属性。 将这些值中的任何一个传递给 ODBC 函数时,驱动程序必须检查该值是否有效。 在适用于其他驱动程序时,驱动程序针对其特定功能返回 SQLSTATE HYC00(可选功能未实现)。
定义基值以促进驱动程序开发。 例如,可以采用以下格式定义特定于驱动程序的诊断属性:
SQL_DRIVER_DIAGNOSTIC_BASE+0, SQL_DRIVER_DIAGNOSTIC_BASE +1