版本:latest

SQLFreeStmt

功能描述

用于释放语句句柄,其功能可被SQLFreeHandle函数替代。

原型

c
SQLRETURN SQLFreeStmt(SQLHSTMT      StatementHandle,
                      SQLUSMALLINT  Option);

参数

表 1 SQLFreeStmt参数

关键字

参数说明

StatementHandle

要释放的语句句柄。

Option

指定要执行的操作类型。

返回值

  • SQL_SUCCESS:表示调用正确。
  • SQL_SUCCESS_WITH_INFO:表示会有一些警告信息。
  • SQL_ERROR:执行失败,语句句柄未被释放。
  • SQL_INVALID_HANDLE:表示传入的语句句柄无效。

注意事项

如果SQLFreeStmt返回SQL_ERROR,语句句柄仍然有效。为了使得代码更健壮并易于维护,建议使用标准化接口SQLFreeHandle替代SQLFreeStmt。

示例

参见:示例