SQLCloseCursor
SQLCloseCursor#
열려진 커서를 닫고 보류중인 결과들을 폐기한다.
구 문#
SQLRETURN SQLCloseCursor (
SQLHSTMT stmt);
인 자#
| 자료유형 | 인자 | 사용 | 설명 |
|---|---|---|---|
| SQLHSTMT | stmt | 입력 | 명령문 핸들 |
결괏값#
SQL_SUCCESS
SQL_SUCCESS_WITH_INFO
SQL_INVALID_HANDLE
SQL_ERROR
설 명#
열려진 커서를 닫고 보류중인 결과들을 폐기한다.
SQLFreeStmt()에서 SQL_CLOSE 옵션을 사용한 것과 동일하다. 단 SQLCloseCursor()에서 커서가 열려지지 않았을 때 오류 24000을 발생시킨다.
진 단#
| SQLSTATE | 설명 | 부연설명 |
|---|---|---|
| HY000 | 일반 오류 | |
| HY001 | 메모리 할당 오류 | 명시된 핸들을 위한 메모리 할당에 실패함 |
| 24000 | 커서 상태가 잘못됨 | 명령문 핸들에 열려진 커서가 없음 |
관련 함수#
SQLFreeHandle