SQLFreeStmt()

Development/C/C++ 2011. 8. 13. 15:05

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

 

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 일반 오류  

예 제

< $ALTIBASE_HOME/sample/SQLCLI/demo_ex1.cpp 참고 >
SQLFreeStmt(stmt, SQL_DROP);              
              
안정적인 DNS서비스 DNSEver DNS server, DNS service
Posted by 키르히아이스
,