语句句柄

语句句柄是执行数据库查询的基本单位，它与SQL语句相关联，保存了SQL语句的执行信息和执行结果，如执行期参数信息和结果集。语句句柄执行的SQL语句可能是应用程序提供的，如使用SQLExecDirect和SQLExecute时；也可能是驱动内建的，如使用Catalog函数时。

语句句柄必须属于并只能属于一个已经建立连接的连接句柄，但一个连接句柄下可以有多个语句句柄。以一个已经建立连接的连接句柄为参数，应用程序可以调用SQLAllocHandle和SQLFreeHandle分配或释放语句句柄。

通过语句句柄，应用程序可以调用下列类型的ODBC API函数：

• 语句属性函数SQLGetStmtAttr和SQLSetStmtAttr；
• 参数或结果集绑定函数SQLBindParameter和SQLBindCol；
• 语句准备和执行函数SQLPrepare和SQLExecDirect、SQLExecute；
• 语句信息函数SQLNumParameter和SQLDescribeParameter；
• 执行期参数函数SQLPutData和SQLParam；
• 结果集信息函数SQLNumCols、SQLNumRows、SQLDescribeCol和SQLColAttributes；
• 结果集数据获取函数SQLMoreResult和SQLGetData；
• 游标相关函数SQLGetCursorName、SQLSetCursorName、SQLFetch、SQLFetchScroll、SQLSetPos和SQLBulkOperations；
• 大部分Catalog函数；
• 诊断信息函数。