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查找在上一次调用中已成功返回到用户缓冲区中的行数。