10bet网址
连接器和api手册
本手册下载
PDF (Ltr)- 5.2 mb
PDF (A4)- 5.2 mb


5.7.1连接器/ODBC API参考

本节根据功能分类,总结ODBC例程。

有关完整的ODBC API参考,请参阅ODBC程序员参考http://msdn.microsoft.com/en-us/library/ms714177.aspx

应用程序可以调用SQLGetInfo函数获取有关Connector/ODBC的一致性信息。要获得驱动程序中特定功能的支持信息,应用程序可以调用sqlget函数

请注意

为了向后兼容,Connector/ODBC驱动程序支持所有已弃用的功能。

下表列出了按任务分组的连接器/ODBC API调用:

表5.5连接数据源的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLAllocHandle 是的 ISO 92 获取环境、连接、语句或描述符句柄。
SQLConnect 是的 ISO 92 通过数据源名称、用户ID和密码连接到特定驱动程序。
SQLDriverConnect 是的 ODBC 通过连接字符串或要求驱动程序管理器和驱动程序为用户显示连接对话框连接到特定的驱动程序。
SQLAllocEnv 是的 弃用 获取从驱动程序分配的环境句柄。
SQLAllocConnect 是的 弃用 获取连接句柄

表5.6获取驱动程序和数据源信息的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLDataSources 没有 ISO 92 返回由驱动程序管理器处理的可用数据源列表
SQLDrivers 没有 ODBC 返回已安装驱动程序及其属性的列表,由驱动程序管理器处理
SQLGetInfo 是的 ISO 92 返回有关特定驱动程序和数据源的信息。
sqlget函数 是的 ISO 92 返回支持的驱动程序函数。
SQLGetTypeInfo 是的 ISO 92 返回有关支持的数据类型的信息。

表5.7设置和检索驱动程序属性的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLSetConnectAttr 是的 ISO 92 设置连接属性。
SQLGetConnectAttr 是的 ISO 92 返回连接属性的值。
SQLSetConnectOption 是的 弃用 设置连接选项
SQLGetConnectOption 是的 弃用 返回连接选项的值
SQLSetEnvAttr 是的 ISO 92 设置环境属性。
SQLGetEnvAttr 是的 ISO 92 返回环境属性的值。
SQLSetStmtAttr 是的 ISO 92 设置语句属性。
SQLGetStmtAttr 是的 ISO 92 返回语句属性的值。
SQLSetStmtOption 是的 弃用 设置语句选项
SQLGetStmtOption 是的 弃用 返回语句选项的值

表5.8准备SQL请求的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLAllocStmt 是的 弃用 分配语句句柄
SQLPrepare 是的 ISO 92 准备SQL语句以供以后执行。
SQLBindParameter 是的 ODBC 为SQL语句中的参数分配存储空间。Connector/ODBC 5.2增加了对而且inout参数,通过SQL_PARAM_OUTPUTSQL_PARAM_INPUT_OUTPUT类型说明符。(而且inout参数不支持量变而且LONGBLOB列。)
SQLGetCursorName 是的 ISO 92 返回与语句句柄关联的游标名称。
SQLSetCursorName 是的 ISO 92 指定游标名称。
SQLSetScrollOptions 是的 ODBC 设置控制游标行为的选项。

表5.9提交请求的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLExecute 是的 ISO 92 执行一个准备好的语句。
SQLExecDirect 是的 ISO 92 执行一个语句
SQLNativeSql 是的 ODBC 返回由驱动程序翻译的SQL语句的文本。
SQLDescribeParam 没有 ODBC 返回语句中特定参数的说明。Connector/ odbc不支持—返回的结果不可信。
SQLNumParams 是的 ISO 92 返回语句中参数的数量。
SQLParamData 是的 ISO 92 SQLPutData在执行时提供参数数据。(对于长数据值很有用。)
SQLPutData 是的 ISO 92 发送参数的部分或全部数据值。(对于长数据值很有用。)

表5.10检索结果和关于结果的信息的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLRowCount 是的 ISO 92 返回受插入、更新或删除请求影响的行数。
SQLNumResultCols 是的 ISO 92 返回结果集中的列数。
SQLDescribeCol 是的 ISO 92 描述结果集中的列。
SQLColAttribute 是的 ISO 92 描述结果集中列的属性。
SQLColAttributes 是的 弃用 描述结果集中列的属性。
SQLFetch 是的 ISO 92 返回多个结果行。
SQLFetchScroll 是的 ISO 92 返回可滚动的结果行。
SQLExtendedFetch 是的 弃用 返回可滚动的结果行。
SQLSetPos 是的 ODBC 在获取的数据块中定位游标,并使应用程序能够刷新行集中的数据或更新或删除结果集中的数据。
SQLBulkOperations 是的 ODBC 执行大容量插入和大容量书签操作,包括按书签更新、删除和获取。

表5.11检索错误或诊断信息的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLError 是的 弃用 返回附加的错误或状态信息
SQLGetDiagField 是的 ISO 92 返回附加的诊断信息(诊断数据结构的单个字段)。
SQLGetDiagRec 是的 ISO 92 返回附加的诊断信息(诊断数据结构的多个字段)。

表5.12获取数据源系统表(目录函数)信息的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLColumnPrivileges 是的 ODBC 返回一个或多个表的列列表和关联特权。
SQLColumns 是的 X /开放 返回指定表中的列名列表。
SQLForeignKeys 是的 ODBC 返回组成外键的列名列表(如果外键对于指定表存在)。
SQLPrimaryKeys 是的 ODBC 返回构成表主键的列名列表。
SQLSpecialColumns 是的 X /开放 返回关于惟一标识指定表中一行的最佳列集的信息,或者当事务更新行中的任何值时自动更新的列的信息。
SQLStatistics 是的 ISO 92 返回关于单个表和与该表关联的索引列表的统计信息。
SQLTablePrivileges 是的 ODBC 返回表的列表以及与每个表相关的特权。
SQLTables 是的 X /开放 返回存储在特定数据源中的表名列表。

表5.13执行事务的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLTransact 是的 弃用 提交或回滚事务
SQLEndTran 是的 ISO 92 提交回滚一个事务

表5.14终止语句的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
SQLFreeStmt 是的 ISO 92 结束语句处理,丢弃挂起的结果,并可选地释放与语句句柄关联的所有资源。
SQLCloseCursor 是的 ISO 92 关闭已在语句句柄上打开的游标。
SQLCancel 是的 ISO 92 取消SQL语句。

表5.15终止连接的ODBC API调用

函数名 连接器/ ODBC支持吗? 标准 目的
是的 ISO 92 关闭连接。
SQLFreeHandle 是的 ISO 92 释放环境、连接、语句或描述符句柄。
SQLFreeConnect 是的 弃用 释放连接句柄。
SQLFreeEnv 是的 弃用 释放一个环境句柄。