SQLFreeLob

SQLFreeLob

현재의 트랜잭션에서 열린 LOB Locator와 관련된 자원들을 해제한다.

구 문

SQLRETURN SQLFreeLob (
    SQLHSTMT        stmt,
    SQLUBIGINT      locator);

인 자

자료유형	인자	사용	설명
SQLHSTMT	stmt	입력	검색된 결과들에 대한 명령문 핸들
SQLUBIGINT	locator	입력	LOB Locator

결괏값

SQL_SUCCESS
SQL_INVALID_HANDLE
SQL_ERROR

설 명

LOB locator로 대표되는 LOB에 대한 조작이 종료되었음을 서버에게 알려준다. 이로 인해 서버에서 할당된 LOB locator는 해제되며, 그와 관련된 서버의 자원들도 해제된다.

SQLFreeLob()은 LOB locator가 가리키는 LOB에 대한 변경 사항을 commit 또는 rollback하지 않는다. 만약, SQLEndTran()으로 트랜잭션을 종료한 경우, LOB locator는 자동으로 해제되므로 SQLFreeLob()을 호출하지 않아도 된다.

진 단

SQLSTATE	설명	부연설명
08S01	통신 회선 장애 (데이터 송수신 실패)	Altibase CLI 드라이버와 DB간에 함수 처리가 완료되기 전에 통신 회선 실패
HY000	일반 오류

관련 함수

SQLGetLobLength
SQLGetLob
SQLPutLob

예 제

SQLGetLobLength(), SQLGetLob(), SQLPutLob() 의 예제를 참고한다.