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

傳回值

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