ITEEDU

26.1.16. MyODBC API引用

在本节中，概要介绍了按功能分类的ODBC子程序。

关于全部ODBC API参考，请参见ODBC程序员参考，http://msdn.microsoft.com/library/en-us/odbc/htm/odbcabout_this_manual.asp。

应用程序可以调用SQLGetInfo函数来获得关于MyODBC的一致性信息。为了获得驱动程序对特定函数的支持信息，应用程序可调用SQLGetFunctions。

注释：为了向后兼容，MyODBC 3.51驱动程序支持所有已不使用的函数。

在下面的表各中，按任务分组列出了MyODBC API调用：

连接到数据源：

函数名	MyODBC	MyODBC	一致性	目的
	2.50	3.51
SQLAllocHandle	No	Yes	ISO 92	获取环境、连接、语句或描述符句柄。
SQLConnect	Yes	Yes	ISO 92	按数据源名、用户ID和密码连接到特定驱动程序。
SQLDriverConnect	Yes	Yes	ODBC	通过连接字符串，或驱动管理器和驱动显示对话框发出的请求，连接到特定驱动程序。
SQLAllocEnv	Yes	Yes	Deprecated	获得驱动程序分配的环境句柄。
SQLAllocConnect	Yes	Yes	Deprecated	获取连接句柄。

获取关于驱动程序和数据源的信息：

设置并检索驱动属性：

准备SQL请求：

提交请求：

函数名	MyODBC	MyODBC	一致性	目的
	2.50	3.51
SQLExecute	Yes	Yes	ISO 92	执行准备好的语句。
SQLExecDirect	Yes	Yes	ISO 92	执行语句。
SQLNativeSql	Yes	Yes	ODBC	返回由驱动程序翻译的SQL语句的文本。
SQLDescribeParam	Yes	Yes	ODBC	返回语句中特定参数的描述。
SQLNumParams	Yes	Yes	ISO 92	返回语句中的参数数目。
SQLParamData	Yes	Yes	ISO 92	与SQLPutData一起使用，以便在执行时提供参数。（对于长数据值很有用）。
SQLPutData	Yes	Yes	ISO 92	发送某一参数数据值的部分或全部。（对于长数据值很有用）。

检索结果以及关于结果的信息：

函数名	MyODBC	MyODBC	一致性	目的
	2.50	3.51
SQLRowCount	Yes	Yes	ISO 92	返回插入、更新或删除请求影响的行数。
SQLNumResultCols	Yes	Yes	ISO 92	返回结果集中的列数。
SQLDescribeCol	Yes	Yes	ISO 92	描述结果集中的列。
SQLColAttribute	No	Yes	ISO 92	描述结果集中的某1列的属性。
SQLColAttributes	Yes	Yes	Deprecated	描述结果集中的某1列的多个属性。
SQLFetch	Yes	Yes	ISO 92	返回多个结果行。
SQLFetchScroll	No	Yes	ISO 92	返回可滚动结果行。
SQLExtendedFetch	Yes	Yes	Deprecated	返回可滚动结果行。
SQLSetPos	Yes	Yes	ODBC	将光标定为在获取的数据块中，允许应用程序更新行集合中的数据，或更新或删除结果集中的数据。
SQLBulkOperations	No	Yes	ODBC	执行批量插入和批量书签操作，包括更新、删除和按书签获取。

检索错误和诊断信息：

获取关于数据源的系统表（目录函数）条目的信息：

函数名	MyODBC	MyODBC	一致性	目的
	2.50	3.51
SQLColumnPrivileges	Yes	Yes	ODBC	返回关于一个或多个表的列和相关属性的列表。
SQLColumns	Yes	Yes	X/Open	返回指定表中列名的列表。
SQLForeignKeys	Yes	Yes	ODBC	在指定表中如果存在外键，返回构成外键的列名列表。
SQLPrimaryKeys	Yes	Yes	ODBC	返回构成某1表的主键的列名列表。
SQLSpecialColumns	Yes	Yes	X/Open	返回关于最佳列集合的信息，该列集合唯一地指明了指定表中的行，或当某1事务更新了行中的任何值时自动更新的列。
SQLStatistics	Yes	Yes	ISO 92	返回关于单个表的统计信息，以及与表相关的索引列表。
SQLTablePrivileges	Yes	Yes	ODBC	返回表列表，以及与各表相关的权限。
SQLTables	Yes	Yes	X/Open	返回存储在特定数据源内的表名列表。

执行事务：

中止语句：

函数名	MyODBC	MyODBC	一致性	目的
	2.50	3.51
SQLFreeStmt	Yes	Yes	ISO 92	结束语句处理，舍弃未决结果，并释放与语句句柄相关的所有资源（可选）。
SQLCloseCursor	Yes	Yes	ISO 92	关闭在语句句柄上打开的指针。
SQLCancel	Yes	Yes	ISO 92	取消SQL语句。

中止连接：