Documentation Home
MySQL 5.7 C API 开发者指南

5.4.60 mysql_reset_connection()

int
mysql_reset_connection(MYSQL *mysql)

描述

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

mysql_reset_connection()具有类似于 mysql_change_user()或自动重新连接的效果，只是连接未关闭并重新打开，并且未完成重新身份验证。参见 第 5.4.3 节，“mysql_change_user()”和 第 3.6.6 节，“自动重新连接控制”。

mysql_reset_connection() 影响连接相关的状态如下：

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

  • 释放所有表锁。

  • 关闭（并删除）所有TEMPORARY 表。

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

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

  • 发布准备好的语句。

  • 关闭HANDLER变量。

  • 将 的值重置 LAST_INSERT_ID()为 0。

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

返回值

零成功。如果发生错误，则非零。