| Especificación: | CLI de DB2 1.1 | ODBC 1.0 |
|
SQLNumResultCols() devuelve el número de columnas del conjunto resultante asociado al descriptor de sentencia de entrada.
Se debe invocar SQLPrepare() o SQLExecDirect() antes de invocar esta función.
Después de llamar a esta función, puede llamar a SQLColAttribute() o una de las funciones de enlace de columnas.
Sintaxis
SQLRETURN SQLNumResultCols (SQLHSTMT StatementHandle, /* hstmt */
SQLSMALLINT FAR *ColumnCountPtr); /* pccol */
Argumentos de la función
Tabla 72. Argumentos de SQLNumResultCols
| Tipo de datos | Argumento | Uso | Descripción |
|---|---|---|---|
| SQLHSTMT | StatementHandle | entrada | Descriptor de contexto de sentencia. |
| SQLSMALLINT * | ColumnCountPtr | salida | Número de columnas del conjunto resultante. |
Uso
Esta función establece en 0 el argumento de salida si la última sentencia o función ejecutada para el descriptor de sentencia de entrada no generó un conjunto resultante.
Códigos de retorno
Diagnósticos
Tabla 73. SQLSTATE de SQLNumResultCols
| SQLSTATE | Descripción | Explicación |
|---|---|---|
| 40003 08S01 | Error en el enlace de comunicaciones. | El enlace de comunicaciones entre la aplicación y la fuente de datos se interrumpió antes de finalizar la función. |
| 58004 | Error inesperado del sistema. | Error no recuperable del sistema. |
| HY001 | Error de asignación de memoria. | CLI de DB2 no puede asignar la memoria necesaria para ejecutar o finalizar la función. |
| HY010 | Error de secuencia de función. | Se llama a la función antes de llamar a SQLPrepare() o SQLExecDirect() para el descriptor de sentencia (StatementHandle). |
| HY013 | Error inesperado de gestión de la memoria. | CLI de DB2 no puede acceder a la memoria necesaria para ejecutar o finalizar la función. |
Restricciones
Ninguna.
Consulta relacionada