Compartilhar via


Liberar um identificador de instrução ODBC

Como mencionado anteriormente, é mais eficiente reutilizar instruções do que eliminá-las e atribuir novas. Antes de executar uma nova instrução SQL em uma instrução, os aplicativos deverão ter certeza de que as configurações de instrução atuais são apropriadas. Essas configurações incluem atributos de instrução, associações de parâmetro e associações de conjunto de resultados. Geralmente, os parâmetros e os conjuntos de resultados para a instrução SQL antiga precisam ser desassociados (chamando SQLFreeStmt com as opções SQL_RESET_PARAMS e SQL_UNBIND) e reassociados para a nova instrução SQL.

Quando o aplicativo terminar de usar a instrução, ele chama SQLFreeHandle para liberar a instrução. Depois de liberar a instrução, é um erro de programação do aplicativo usar o identificador da instrução em uma chamada para uma função ODBC; fazer isso tem consequências indefinidas, mas provavelmente fatais.

Quando SQLFreeHandle é chamado, o driver libera a estrutura usada para armazenar informações sobre a instrução.

SQLDisconnect libera automaticamente todas as instruções em uma conexão.