SQLCloseCursor -关闭游标语句

在线编辑

SQLCloseCursor() 关闭语句句柄上的打开游标。

语法

SQLRETURN SQLCloseCursor (SQLHSTMT     hstmt);

函数自变量

表 1. SQLCloseCursor 自变量
数据类型 自变量 使用 描述
SQLHSTMT hstmt 输入 语句句柄

用法

调用 SQLCloseCursor() 将关闭与语句句柄关联的任何游标，并废弃任何暂挂结果。 如果没有打开的游标与语句句柄相关联，那么该函数没有任何作用。

如果语句句柄引用了具有多个结果集的存储过程，那么 SQLCloseCursor() 将仅关闭当前结果集。 任何其他结果集都保持打开状态且可用。

返回码

  • SQL_SUCCESS
  • sql_invalid_handle
  • SQL_ERROR

诊断

表 2。 SQLCloseCursor SQLSTATEs
SQLSTATE 描述 说明
08003 * 连接未打开 未建立 hstmt 的连接。
HY009 * 参数值无效 hstmt 不是语句句柄。
HY021 内部描述符无效 无法寻址或分配内部描述符，或者它包含无效的值。