| 规范： | DB2 CLI 1.1 | ODBC 1.0 |
|
SQLNumResultCols() 返回与输入语句句柄相关联的结果集中的列数。
在调用此函数之前，必须调用 SQLPrepare() 或 SQLExecDirect()。
在调用此函数之前，可以调用 SQLColAttribute() 或绑定列函数之一。
语法
SQLRETURN SQLNumResultCols (SQLHSTMT StatementHandle, /* hstmt */
SQLSMALLINT FAR *ColumnCountPtr); /* pccol */
函数自变量
| 数据类型 | 自变量 | 使用 | 描述 |
|---|---|---|---|
| SQLHSTMT | StatementHandle | 输入 | 语句句柄。 |
| SQLSMALLINT * | ColumnCountPtr | 输出 | 结果集中的列数。 |
用法
如果对输入语句句柄执行的最后一个语句或函数未生成结果集，则此函数将输出自变量设置为 0。
返回码
诊断
表 73. SQLNumResultCols SQLSTATE
| SQLSTATE | 描述 | 解释 |
|---|---|---|
| 40003 08S01 | 通信链路故障。 | 函数尚未完成，应用程序与数据源间的通信链路就失效了。 |
| 58004 | 意外系统故障。 | 不可恢复的系统错误。 |
| HY001 | 内存分配失败。 | DB2 CLI 无法分配支持函数的执行或完成所需的内存。 |
| HY010 | 函数顺序错误。 | 在对 StatementHandle 调用 SQLPrepare() 或 SQLExecDirect() 之前调用了该函数。 |
| HY013 | 发生意外的内存处理错误。 | DB2 CLI 无法访问支持函数的执行或完成所需的内存。 |
限制
无。
相关参考