ACIStmtFetch()

ACIStmtFetch()

作用:

从查询中获取行。 推荐使用 ACIStmtFetch2

语法:

sword ACIStmtFetch ( ACIStmt     *stmtp,
                     ACIError    *errhp,
                     ub4          nrows,
                     ub2          orientation,
                     ub4          mode );

参数:

  • stmthp (in)

指向返回的语句句柄的指针。

  • errhp (IN)

指向用于诊断的错误句柄的指针。

  • nrows (IN)

从当前位置获取的行数

  • orientation (IN)

唯一可接受的值为ACI_FETCH_NEXT,这也是默认值。

  • mode (IN)

支持ACI_DEFAULT.

说明:

如果预取的行足够,则fetch调用是本地调用。 但是,这对应用程序是透明的。

如果正在读取LOB列,则将提取LOB定位器,以在这些定位器上执行后续的LOB操作。

发生以下错误之一时,返回值是ACI_NO_DATA结束符或者ACI_SUCCESS_WITH_INFO时,可能是以下原因:

  • ORA-24344-编译错误成功
  • ORA-24345-发生截断或NULL提取错误
  • ORA-24347-聚合函数中的NULL列警告

如果在nrows参数设置为0的情况下调用 ACIStmtFetch ,则将关闭游标。

使用ACI_ATTR_ROWS_FETCHED查找在上一次调用中已成功返回到用户缓冲区中的行数。