| Especificación: | CLI de DB2 1.1 | ODBC 1.0 | ISO CLI |
SQLRowCount() devuelve el número de filas de una tabla que se han visto afectadas por una sentencia UPDATE, INSERT, DELETE o SELECT con cursor desplazable ejecutada sobre la tabla.
Se debe invocar SQLExecute() o SQLExecDirect() antes de invocar esta función.
Sintaxis
SQLRETURN SQLRowCount (SQLHSTMT StatementHandle, /* hstmt */
SQLINTEGER FAR *RowCountPtr); /* pcrow */
Argumentos de la función
Tabla 78. Argumentos de SQLRowCount
| Tipo de datos | Argumento | Uso | Descripción |
|---|---|---|---|
| SQLHSTMT | StatementHandle | entrada | Descriptor de contexto de sentencia. |
| SQLINTEGER | RowCountPtr | salida | Puntero que apunta al lugar donde se almacena el número de filas afectadas por la sentencia. |
Uso
Si la última sentencia ejecutada a la que hace referencia el descriptor de contexto de sentencia de entrada no es una sentencia UPDATE, INSERT ni DELETE, o si la sentencia no se ejecutó satisfactoriamente, la función establece el contenido de RowCountPtr en -1.
El contaje no incluye las filas de otras tablas que pueden haber sido afectadas por la sentencia.
Códigos de retorno
Diagnósticos
Tabla 79. SQLSTATE de SQLRowCount
| SQLSTATE | Descripción | Explicación |
|---|---|---|
| 40003
08S01 | Anomalía de enlace de comunicaciones. | El enlace de comunicaciones entre la aplicación y la fuente de datos ha fallado antes de que se completara la función. |
| 58004 | Anomalía inesperada del sistema. | Error no recuperable del sistema. |
| HY001 | Anomalía de asignación de memoria. | La CLI de DB2 no puede asignar la memoria necesaria para soportar la ejecución o realización de la función. Es probable que la memoria de nivel de proceso se haya agotado para el proceso de aplicaciones. Consulte la configuración del sistema operativo para obtener información sobre las limitaciones de memoria de nivel de proceso. |
| HY010 | Error de secuencia de función. | Se llama a la función antes de llamar a SQLExecute() o SQLExecDirect() para el descriptor de contexto de sentencia (StatementHandle). |
| HY013 | Error inesperado de manejo de memoria. | La CLI de DB2 no ha podido acceder a la memoria necesaria para soportar la ejecución o realización de la función. |
Restricciones
Ninguna.
Consulta relacionada