Het vrijmaken van een Statement Handle ODBC

Zoals eerder vermeld, is het efficiënter om instructies opnieuw te gebruiken dan ze te verwijderen en nieuwe toe te wijzen. Voordat u een nieuwe SQL-instructie uitvoert op een instructie, moeten toepassingen ervoor zorgen dat de huidige instellingen van de instructie geschikt zijn. Dit zijn onder andere instructiekenmerken, parameterbindingen en bindingen voor resultatensets. Over het algemeen moeten parameters en resultatensets voor de oude SQL-instructie worden losgekoppeld (door SQLFreeStmt aan te roepen met de SQL_RESET_PARAMS- en SQL_UNBIND-opties) en opnieuw worden gekoppeld voor de nieuwe SQL-instructie.

Wanneer de toepassing klaar is met het gebruik van de instructie, wordt SQLFreeHandle aanroepen om de instructie vrij te maken. Na het vrijgeven van de instructie is het een programmeerfout in de toepassing om de handle van de instructie te gebruiken in een aanroep naar een ODBC-functie; dit heeft ongedefinieerde, maar mogelijk fatale gevolgen.

Wanneer SQLFreeHandle wordt aangeroepen, geeft het stuurprogramma de structuur vrij die wordt gebruikt om informatie over de instructie op te slaan.

SQLDisconnect geeft automatisch alle instructies voor een verbinding vrij.