文档首页
MySQL 8.4 C API 开发人员指南
下载此手册
PDF (US Ltr) - 1.4Mb
PDF (A4) - 1.4Mb


MySQL 8.4 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() 后定义的任何当前查询属性。

返回值

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