Fechando o cursor

Quando um aplicativo terminar de usar um cursor, ele chamará SQLCloseCursor para fechar o cursor. Por exemplo:

SQLCloseCursor(hstmt);  

Até que o aplicativo feche o cursor, a instrução na qual o cursor é aberto não pode ser usada para a maioria das outras operações, como a execução de outra instrução SQL. Para obter uma lista completa de funções que podem ser chamadas enquanto um cursor está aberto, consulte Apêndice B: Tabelas de Transição de Estado ODBC.

Observação

Para fechar um cursor, um aplicativo deve chamar SQLCloseCursor, não SQLCancel.

Os cursores permanecem abertos até serem fechados explicitamente, exceto quando uma transação é confirmada ou revertida, nesse caso, algumas fontes de dados fecham o cursor. Em particular, chegar ao final do conjunto de resultados, quando SQLFetch retorna SQL_NO_DATA, não fecha um cursor. Mesmo cursores em conjuntos de resultados vazios (conjuntos de resultados criados quando uma instrução foi executada com êxito, mas que não retornou linhas) devem ser explicitamente fechados.