ODBC 函数摘要
下表列出了按任务类型分组的 ODBC 函数，并包括一致性指定和每个函数用途的简要说明。 有关一致性指定的详细信息，请参阅 ODBC 和标准 CLI。 有关每个函数的语法和语义的详细信息，请参阅 ODBC API 参考。
应用程序可以调用 SQLGetInfo 函数以获取有关驱动程序的一致性信息。 若要获取有关驱动程序中特定函数支持的信息，应用程序可以调用 SQLGetFunctions。
| 任务 | 函数名 | 一致性 | 用途 |
|---|---|---|---|
| 连接到数据源 | SQLAllocHandle | ISO 92 | 获取环境、连接、语句或描述符句柄。 |
| SQLConnect | ISO 92 | 按数据源名称、用户 ID 和密码连接到特定驱动程序。 | |
| SQLDriverConnect | ODBC | 通过连接字符串或请求驱动程序管理器和驱动程序向用户显示连接对话框，连接到特定驱动程序。 | |
| SQLBrowseConnect | ODBC | 返回连接属性和有效属性值的连续级别。 为每个连接属性指定值后，连接到数据源。 | |
| 获取有关驱动程序和数据源的信息 | SQLDataSources SQLDrivers |
ISO 92 ODBC |
返回可用数据源的列表。 返回已安装的驱动程序及其属性的列表。 |
| SQLGetInfo | ISO 92 | 返回有关特定驱动程序和数据源的信息。 | |
| SQLGetFunctions | ISO 92 | 返回支持的驱动程序函数。 | |
| SQLGetTypeInfo | ISO 92 | 返回关于支持数据类型的信息。 | |
| 设置和检索驱动程序属性 | SQLSetConnectAttr SQLGetConnectAttr |
ISO 92 ISO 92 |
设置连接属性。 返回连接特性的值。 |
| SQLSetEnvAttr | ISO 92 | 设置环境属性。 | |
| SQLGetEnvAttr | ISO 92 | 返回环境特性的值。 | |
| SQLSetStmtAttr | ISO 92 | 设置语句属性。 | |
| SQLGetStmtAttr | ISO 92 | 返回语句特性的值。 | |
| 设置和检索描述符字段 | SQLGetDescField SQLGetDescRec |
ISO 92 ISO 92 |
返回单个描述符字段的值。 返回多个描述符字段的值。 |
| SQLSetDescField | ISO 92 | 设置单个描述符字段。 | |
| SQLSetDescRec | ISO 92 | 设置多个描述符字段。 | |
| SQLCopyDesc | ISO 92 | 将描述符信息从一个描述符句柄复制到另一个描述符句柄。 | |
| 准备 SQL 请求 | SQLPrepare | ISO 92 | 准备 SQL 语句以供以后执行。 |
| SQLBindParameter | ODBC | 为 SQL 语句中的参数分配存储。 | |
| SQLGetCursorName | ISO 92 | 返回与语句句柄关联的游标名称。 | |
| SQLSetCursorName | ISO 92 | 指定游标名称。 | |
| SQLSetScrollOptions | ODBC | 设置控制游标行为的选项。 | |
| 提交请求 | SQLExecute SQLExecDirect |
ISO 92 ISO 92 |
执行已准备的语句。 执行语句。 |
| SQLNativeSql | ODBC | 返回驱动程序翻译的 SQL 语句的文本。 | |
| SQLDescribeParam | ODBC | 返回语句中特定参数的说明。 | |
| SQLNumParams | ISO 92 | 返回语句中的参数数。 | |
| SQLParamData | ISO 92 | 与 SQLPutData 结合使用，在执行时提供参数数据。 （适用于长数据值。） | |
| SQLPutData | ISO 92 | 发送参数的部分或所有数据值。 （适用于长数据值。） | |
| 检索结果和有关结果的信息 | SQLRowCount SQLNumResultCols |
ISO 92 ISO 92 |
返回受插入、更新或删除请求影响的行数。 返回结果集中的列数。 |
| SQLDescribeCol | ISO 92 | 描述结果集中的列。 | |
| SQLColAttribute | ISO 92 | 描述结果集中列的属性。 | |
| SQLBindCol | ISO 92 | 为结果列分配存储并指定数据类型。 | |
| SQLFetch | ISO 92 | 返回多个结果行。 | |
| SQLFetchScroll | ISO 92 | 返回可滚动的结果行。 | |
| SQLGetData | ISO 92 | 返回结果集一行的一列或全部一列。 （适用于长数据值。） | |
| SQLSetPos | ODBC | 将游标置于提取的数据块中，并允许应用程序刷新行集中的数据，或者更新或删除结果集中的数据。 | |
| SQLBulkOperations | ODBC | 执行批量插入和批量书签操作，包括按书签进行更新、删除和提取。 | |
| SQLMoreResults | ODBC | 确定是否有更多的结果集可用，如果是，则初始化下一个结果集的处理。 | |
| SQLGetDiagField | ISO 92 | 返回其他诊断信息（诊断数据结构的单个字段）。 | |
| SQLGetDiagRec | ISO 92 | 返回其他诊断信息（诊断数据结构的多个字段）。 | |
| 获取有关数据源的系统表的信息（目录函数） | SQLColumnPrivileges SQLColumns |
ODBC 打开组 |
返回一个或多个表的列和关联权限的列表。 返回指定表中的列名列表。 |
| SQLForeignKeys | ODBC | 返回构成外键的列名列表（如果指定表存在）。 | |
| SQLPrimaryKeys | ODBC | 返回构成表主键的列名列表。 | |
| SQLProcedureColumns | ODBC | 返回输入和输出参数的列表，以及构成指定过程的结果集的列。 | |
| SQLProcedures | ODBC | 返回存储在特定数据源中的过程名称的列表。 | |
| SQLSpecialColumns | 打开组 | 返回有关唯一标识指定表中某一行的列集的信息，或当行中的任何值由事务更新时自动更新的列的信息。 | |
| SQLStatistics | ISO 92 | 返回与表关联的单个表和索引列表的统计信息。 | |
| SQLTablePrivileges | ODBC | 返回与每个表关联的表和特权的列表。 | |
| SQLTables | 打开组 | 返回存储在特定数据源中的表名的列表。 | |
| 终止语句 | SQLFreeStmt | ISO 92 | 结束语句处理、放弃挂起的结果，以及（可选）释放与语句句柄关联的所有资源。 |
| SQLCloseCursor | ISO 92 | 关闭已在语句句柄上打开的游标。 | |
| SQLCancel | ISO 92 | 取消对语句的处理。 | |
| SQLCancelHandle | ODBC | 取消语句或连接上的处理。 | |
| SQLEndTran | ISO 92 | 提交或回滚事务。 | |
| 终止连接 | SQLDisconnect SQLFreeHandle |
ISO 92 ISO 92 |
关闭连接。 释放环境、连接、语句或描述符句柄。 |