Compartilhar via


Liberar um identificador de instrução ODBC

Conforme mencionado anteriormente, é mais eficiente reutilizar instruções do que descartá-las e alocar novas. Antes de executar uma nova instrução SQL em uma instrução, os aplicativos devem ter certeza de que as configurações de instrução atuais são apropriadas. Isso inclui atributos de instrução, associações de parâmetro e associações de conjuntos de resultados. Geralmente, parâmetros e conjuntos de resultados para a instrução SQL antiga precisam ser desvinculados (chamando SQLFreeStmt com as opções SQL_RESET_PARAMS e SQL_UNBIND) e vinculados novamente para a nova instrução SQL.

Quando o aplicativo terminar de usar a instrução, ele chamará 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 declarações em uma conexão.