콘텐츠로 이동

SQLFreeLob2

SQLFreeLob2#

JSON 데이터 타입과 관련된 LOB Locator의 자원들을 해제한다.

구 문#

SQLRETURN SQLFreeLob2 (
    SQLHSTMT        stmt,
    SQLUBIGINT      locator);

인 자#

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

결과값#

SQL_SUCCESS
SQL_INVALID_HANDLE
SQL_ERROR

설 명#

SQLFreeLob2함수는 JSON 데이터의 갱신을 위해 SQLPutLob 함수를 사용한 경우, LOB Locator와 관련된 자원을 해제하기 위해 사용한다. 따라서 JSON 데이터의 갱신 후에는 SQLFreeLob2 함수를 반드시 호출해야 한다.

SQLFreeLob2()는 LOB locator가 가리키는 LOB에 대한 변경 사항을 commit 또는 rollback하지 않는다.

진 단#

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

관련함수#

SQLPutLob

예 제#

sample의 예제를 참고한다.