| Especificación: | CLI de DB2 1.1 | ODBC 1.0 | ISO CLI |
SQLDisconnect() cierra la conexión asociada al descriptor de conexión de la base de datos.
Después de invocar esta función, invoque SQLConnect() para conectar con otra base de datos o bien invoque SQLFreeHandle().
Sintaxis
SQLRETURN SQLDisconnect (SQLHDBC ConnectionHandle;) /* hdbc */
Argumentos de la función
Tabla 40. Argumentos de SQLDisconnect
| Tipo de datos | Argumento | Uso | Descripción |
|---|---|---|---|
| SQLHDBC | ConnectionHandle | entrada | Descriptor de contexto de conexión. |
Uso
Si una aplicación invoca SQLDisconnect() antes de haber liberado todos los descriptores de contexto de sentencia asociados a la conexión, CLI de DB2 los libera después de desconectarse satisfactoriamente de la base de datos.
Si se devuelve SQL_SUCCESS_WITH_INFO, significa que desconexión de la base de datos se ha realizado satisfactoriamente pero existe información adicional sobre errores o específica de la implementación. Por ejemplo, se encontró un problema durante el proceso posterior a la desconexión de la conexión o no existe ninguna conexión actual debido a un suceso que se produjo independientemente de la aplicación (por ejemplo, un error de comunicaciones).
Después de invocar SQLDisconnect() satisfactoriamente, la aplicación puede reutilizar el argumento ConnectionHandle para hacer otra petición SQLConnect() o SQLDriverConnect().
Códigos de retorno
Diagnósticos
Tabla 41. SQLSTATE de SQLDisconnect
| SQLSTATE | Descripción | Explicación |
|---|---|---|
| 01002 | Error de desconexión. | Se produjo un error durante la desconexión. Sin embargo, la desconexión se realizó satisfactoriamente. (La función devuelve SQL_SUCCESS_WITH_INFO). |
| 08003 | La conexión está cerrada. | La conexión especificada en el argumento ConnectionHandle no está abierta. |
| 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. |
| 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