文件首頁
MySQL 9.0 C API 開發人員指南
下載本手冊
PDF (美式信紙) - 1.4Mb
PDF (A4) - 1.4Mb


5.4.56 mysql_ping()

int
mysql_ping(MYSQL *mysql)

說明

檢查與伺服器的連線是否正常運作。如果連線已斷線且啟用自動重新連線,則會嘗試重新連線。如果連線斷線且停用自動重新連線,則 mysql_ping() 會傳回錯誤。

預設停用自動重新連線。若要啟用它,請使用 MYSQL_OPT_RECONNECT 選項 (已棄用) 呼叫 mysql_options()。如需詳細資訊,請參閱 第 5.4.54 節,「mysql_options()」

mysql_ping() 可讓閒置很久的用戶端用來檢查伺服器是否已關閉連線,並在必要時重新連線。

如果 mysql_ping()) 確實導致重新連線,則不會明確指示。若要判斷是否發生重新連線,請在呼叫 mysql_ping() 之前呼叫 mysql_thread_id() 以取得原始連線識別碼,然後再次呼叫 mysql_thread_id(),查看識別碼是否已變更。

如果發生重新連線,則連線的某些特性將會重設。如需這些特性的詳細資訊,請參閱 第 3.6.8 節,「自動重新連線控制」

傳回值

如果連線到伺服器處於活動狀態,則傳回零。如果發生錯誤,則傳回非零值。非零傳回值不表示 MySQL 伺服器本身已關閉;連線可能會因其他原因 (例如網路問題) 而中斷。

錯誤