文件首頁
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() 所定義的任何目前查詢屬性。

傳回值

成功則為零。如果發生錯誤則為非零。