SQLDisconnect

SQLDisconnect#

특정 연결 핸들과 관련된 연결을 종료한다.

SQLRETURN  SQLDisconnect (
    SQLHDBC     dbc );

자료유형	인자	사용	설명
SQLHDBC	dbc	입력	연결 핸들

SQL_SUCCESS
SQL_SUCCESS_WITH_INFO
SQL_INVALID_HANDLE
SQL_ERROR

연결과 연관된 명령문 핸들을 모두 해제하기 전에 애플리케이션이 SQLDisconnect()를 호출하면, 데이터베이스로부터 연결을 단절한다.

SQL_SUCCESS_WITH_INFO가 리턴되면, 이는 데이터베이스 단절이 성공적이지만 추가 오류 또는 특정 구현 프로그램정보가 있음을 의미한다. 예를 들면 다음과 같다.

단절 후에 정리하는 과정에서 문제가 발생하였거나

애플리케이션과는 독립적으로 발생한 이벤트(통신실패 같은)로 인해 현재는 연결되지 않은 경우

성공적인 SQLDisconnect() 호출 후에 또 다른 SQLConnect() 요구를 하기위해 애플리케이션은 dbc를 다시 사용할수 있다.

이 함수를 호출한 후에 다른 데이터베이스에 연결하기 위해 SQLConnect()를 호출하거나 SQLDriverConnect()를 호출해야 한다.

SQLSTATE	설명	부연설명
HY000	일반 오류

< $ALTIBASE_HOME/sample/SQLCLI/demo_ex1.cpp 참고 >

SQLDisconnect( dbc );