| 规范： | DB2 CLI 2.1 | ODBC 1.0 |
|
SQLNumParams() 返回 SQL 语句中的参数标记数目。
语法
SQLRETURN SQLNumParams (SQLHSTMT StatementHandle,
SQLSMALLINT FAR *ParameterCountPtr);
函数自变量
| 数据类型 | 自变量 | 使用 | 描述 |
|---|---|---|---|
| SQLHSTMT | StatementHandle | 输入 | 语句句柄。 |
| SQLSMALLINT | ParameterCountPtr | 输出 | 语句中的参数数目。 |
用法
只能在准备与 StatementHandle 相关联的语句之后调用此函数。如果语句不包含任何参数标记，则 ParameterCountPtr 设置为零。
应用程序可调用此函数来确定与该语句句柄相关联的 SQL 语句需要多少个 SQLBindParameter() 调用。
返回码
诊断
| SQLSTATE | 描述 | 解释 |
|---|---|---|
| HY001 | 内存分配失败。 | DB2 CLI 无法分配支持函数的执行或完成所需的内存。 |
| HY010 | 函数顺序错误。 | 在对指定 StatementHandle 调用 SQLPrepare() 之前调用了此函数。 |
| HY013 | 发生意外的内存处理错误。 | DB2 CLI 无法访问支持该函数的执行或完成所需的内存。 |
限制
无。
相关参考