SQLFreeStmt()

출처 : http://data.altibase.com/pdf/a3/htm/cli/ch03s23.html

 

SQLFreeStmt
Prev	Chapter 3. Altibase CLI 함수	Next

---

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);              
              

---

Prev	Up	Next
SQLFreeHandle	Home	SQLGetConnectAttr