| title | Freeing a Statement Handle | Microsoft Docs | ||||||
|---|---|---|---|---|---|---|---|
| ms.custom | |||||||
| ms.date | 03/03/2017 | ||||||
| ms.prod | sql | ||||||
| ms.prod_service | database-engine, sql-database, sql-data-warehouse, pdw | ||||||
| ms.reviewer | |||||||
| ms.technology | native-client | ||||||
| ms.topic | reference | ||||||
| helpviewer_keywords |
|
||||||
| ms.assetid | 96fdff84-0ca7-460a-a240-94ee826ea41c | ||||||
| author | markingmyname | ||||||
| ms.author | maghan | ||||||
| monikerRange | >=aps-pdw-2016||=azuresqldb-current||=azure-sqldw-latest||>=sql-server-2016||=sqlallproducts-allversions||>=sql-server-linux-2017||=azuresqldb-mi-current |
[!INCLUDEappliesto-ss-asdb-asdw-pdw-md]
It is more efficient to reuse statement handles than to drop them and allocate new ones. Before executing a new SQL statement on a statement handle, applications should verify that the current statement settings are appropriate. These include statement attributes, parameter bindings, and result set bindings. Generally, parameters and result sets for the old SQL statement must be unbound by calling SQLFreeStmt with the SQL_RESET_PARAMS and SQL_UNBIND options and then re-bound for the new SQL statement.
When the application has finished using the statement, it calls SQLFreeHandle to free the statement. Note that SQLDisconnect automatically frees all statements on a connection.