SQLFreeStmt (Cursor Library)

Important

This feature will be removed in a future version of Windows. Avoid using this feature in new development work and plan to modify applications that currently use this feature. Microsoft recommends using the driver's cursor functionality.

This topic discusses the use of the SQLFreeStmt function in the cursor library. For general information about SQLFreeStmt, see SQLFreeStmt Function.

If an application calls SQLFreeStmt with the SQL_UNBIND option after it calls SQLExtendedFetch, SQLFetch, or SQLFetchScroll, the cursor library returns an error. Before it can unbind result set columns, an application must call SQLCloseCursor or SQLFreeStmt with the SQL_CLOSE option.