Освобождение дескриптора инструкцииFreeing a Statement Handle

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics даПараллельное хранилище данныхParallel Data WarehouseyesПараллельное хранилище данныхParallel Data WarehouseПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics даПараллельное хранилище данныхParallel Data WarehouseyesПараллельное хранилище данныхParallel Data Warehouse

Многократное использование дескрипторов инструкций значительно эффективнее, чем их удаление и повторное выделение.It is more efficient to reuse statement handles than to drop them and allocate new ones. Перед выполнением новой инструкции SQL через дескриптор приложение должно проверить правильность текущих параметров инструкции,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. Как правило, параметры и результирующие наборы для старой инструкции SQL должны быть отменены путем вызова SQLFreeStmt с параметрами SQL_RESET_PARAMS и SQL_UNBIND и повторной привязки для новой инструкции SQL.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.

Когда приложение завершит работу с инструкцией, оно вызывает SQLFreeHandle , чтобы освободить инструкцию.When the application has finished using the statement, it calls SQLFreeHandle to free the statement. Обратите внимание, что SQLDisconnect автоматически освобождает все инструкции по соединению.Note that SQLDisconnect automatically frees all statements on a connection.

См. также:See Also

Выполняя запросы (ODBC)Executing Queries (ODBC)