| Especificación: | CLI de DB2 2.1 | ODBC 1.0 |
|
SQLNumParams() devuelve el número de marcadores de parámetro de una sentencia de SQL.
Sintaxis
SQLRETURN SQLNumParams (SQLHSTMT StatementHandle,
SQLSMALLINT FAR *ParameterCountPtr);
Argumentos de la función
Tabla 94. Argumentos de SQLNumParams
| Tipo de datos | Argumento | Uso | Descripción |
|---|---|---|---|
| SQLHSTMT | StatementHandle | Entrada | Descriptor de contexto de sentencia. |
| SQLSMALLINT | ParameterCountPtr | Salida | Número de parámetros de la sentencia. |
Uso
Esta función sólo puede llamarse después de que se haya preparado la sentencia asociada con StatementHandle. Si la sentencia no contiene ningún marcador de parámetro, ParameterCountPtr se establece en 0.
Una aplicación puede llamar a esta función para determinar el número de llamadas SQLBindParameter() necesarias para la sentencia SQL asociada con el descriptor de sentencia.
Códigos de retorno
Diagnósticos
Tabla 95. SQLNumParams SQLSTATEs
| SQLSTATE | Descripción | Explicación |
|---|---|---|
| HY001 | Error de asignación de memoria. | DB2 CLI no puede asignar la memoria necesaria para ejecutar o finalizar la función. |
| HY010 | Error de secuencia de función. | Esta función se llamó antes de que se llamara SQLPrepare() para la StatementHandle especificada. |
| HY013 | Error inesperado de gestión de la memoria. | DB2 CLI no pudo acceder a la memoria necesaria para ejecutar o finalizar la función. |
Restricciones
Ninguna.
Consulta relacionada