Partilhar via


Liberando um identificador de instrução ODBC

Como mencionado anteriormente, é mais eficiente reutilizar instruções do que eliminá-las e alocar novas. Antes de executar uma nova instrução SQL numa instrução, as aplicações devem certificar-se de que as definições atuais da instrução são adequadas. Estes incluem atributos de instruções, ligações de parâmetros e associações de conjuntos de resultados. Geralmente, os parâmetros e conjuntos de resultados para a antiga instrução SQL precisam de ser desvinculados (chamando SQLFreeStmt com as opções SQL_RESET_PARAMS e SQL_UNBIND) e reassociados para a nova instrução SQL.

Quando a aplicação termina de usar a instrução, chama SQLFreeHandle para libertar a instrução. Após libertar a declaração, é um erro de programação de aplicação usar o handle da declaração numa chamada a uma função ODBC; fazê-lo tem consequências indefinidas, mas provavelmente fatais.

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

O SQLDisconnect liberta automaticamente todas as instruções numa ligação.