SQLFreeStmt

SQLFreeStmt

특정 명령문과 관련된 처리를 멈추고, 보류중인 결과들을 폐기하거나 또는 명령문 핸들과 관련된 모든 자원들을 해제한다.

구 문

SQLRETURN  SQLFreeStmt (
    SQLHSTMT    stmt,
    SQLSMALLINT fOption );

인 자

자료유형	인자	사용	설명
SQLHSTMT	stmt	입력	명령문 핸들
SQLSMALLINT	fOption	입력	핸들 해제 방식 SQL_CLOSE SQL_DROP SQL_UNBIND SQL_RESET_PARAMS

결괏값

SQL_SUCCESS
SQL_SUCCESS_WITH_INFO
SQL_INVALID_HANDLE
SQL_ERROR

설 명

다음 옵션과 함께 SQLFreeStmt()를 호출할 수 있다.

SQL_CLOSE

stmt와 관련된 커서를 닫고 모든 보류중인 결과들을 폐기한다. 애플리케이션은 같은 또는 다른 변수들을 사용해 다시 SELECT 문을 수행함으로서 나중에 이 커서를 다시 열 수 있다. 만약 어떠한 커서도 열려 있지 않으면, 이 옵션은 애플리케이션에 대해 아무런 영향을 주지 않는다.

SQL_DROP

입력 명령문 핸들과 연관된 자원이 해제되고 핸들이 무효화된다. 열린 커서가 있는 경우 닫히고 모든 미결인 결과가 삭제된다.

SQL_UNBIND

이 명령문 핸들에서 이전의 SQLBindCol() 호출에 의해 바인드된 모든 열이 해제된다.

SQL_RESET_PARAMS

이 명령문 핸들에서 이전의 SQLBindParameter() 호출에 의해 설정된 모든 매개변수가 해제된다. 애플리케이션 변수 또는 파일 참조와 명령문 핸들의 SQL문 매개변수 마커 사이의 연관이 깨진다.

진 단

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

관련 함수

SQLAllocHandle
SQLFreeHandle

예 제

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

SQLFreeStmt(stmt, SQL_DROP);