| 规范： | DB2 CLI 1.1 | ODBC 1.0 | ISO CLI |
SQLRowCount() 返回表中某些行的数目， 这些行受到对表执行的带有可滚动游标的 UPDATE、INSERT、DELETE 或 SELECT 语句的影响。
在调用此函数之前，必须调用 SQLExecute() 或 SQLExecDirect()。
语法
SQLRETURN SQLRowCount (SQLHSTMT StatementHandle, /* hstmt */
SQLINTEGER FAR *RowCountPtr); /* pcrow */
函数自变量
| 数据类型 | 自变量 | 使用 | 描述 |
|---|---|---|---|
| SQLHSTMT | StatementHandle | 输入 | 语句句柄。 |
| SQLINTEGER | RowCountPtr | 输出 | 指向存储受影响行数的位置的指针。 |
用法
如果输入语句句柄引用的上次执行的语句不是 UPDATE、INSERT 或 DELETE 语句，或者，如果该语句未成功执行，则此函数将 RowCountPtr 的内容设置为 -1。
其它表中任何可能受该语句影响的行都不包括在此计数中。
返回码
诊断
| SQLSTATE | 描述 | 解释 |
|---|---|---|
| 40003
08S01 | 通信链路发生故障。 | 在功能完成之前应用程序与数据源之间的通信链接失效。 |
| 58004 | 发生意外系统故障。 | 不可恢复的系统错误。 |
| HY001 | 发生内存分配故障。 | DB2 CLI 未能分配支持功能执行或完成所需的内存。应用程序进程有可能已用完应用程序级内存。有关进程级内存限制的信息，参见操作系统配置。 |
| HY010 | 发生函数序列错误。 | 在对 StatementHandle 调用 SQLExecute() 或 SQLExecDirect() 之前调用了该函数。 |
| HY013 | 发生意外的内存处理错误。 | DB2 CLI 未能访问支持功能执行或完成所需的内存。 |
限制
无。
相关参考