文档首页
MySQL 9.0 C API 开发者指南
下载本手册
PDF (US Ltr) - 1.4Mb
PDF (A4) - 1.4Mb


MySQL 9.0 C API 开发者指南  /  ...  /  mysql_reset_connection()

5.4.65 mysql_reset_connection()

int
mysql_reset_connection(MYSQL *mysql)

描述

重置连接以清除会话状态。

mysql_reset_connection() 的效果类似于 mysql_change_user() 或自动重新连接,区别在于连接不会关闭并重新打开,并且不会重新进行身份验证。写入集会话历史记录将重置。参见 第 5.4.4 节“mysql_change_user()”第 3.6.8 节“自动重新连接控制”

mysql_reset_connection() 会影响以下与连接相关的状态

  • 回滚任何活动的事务并重置自动提交模式。

  • 释放所有表锁。

  • 关闭(并删除)所有 TEMPORARY 表。

  • 将会话系统变量重新初始化为相应全局系统变量的值,包括由语句隐式设置的系统变量,例如 SET NAMES

  • 丢失用户定义的变量设置。

  • 释放预处理语句。

  • 关闭 HANDLER 变量。

  • LAST_INSERT_ID() 的值重置为 0。

  • 释放使用 GET_LOCK() 获取的锁。

  • 清除调用 mysql_bind_param() 后定义的任何当前查询属性。

返回值

成功返回零。如果发生错误,则返回非零值。