10bet网址
MySQL 5.7 C API开发指南
本手册下载
PDF (Ltr)- 1.1 mb
PDF (A4)- 1.1 mb
HTML下载(TGZ)- 147.1 kb
HTML下载(邮政编码)- 156.9 kb


5.4.52 mysql_ping ()

int mysql_ping (MYSQL * MYSQL)

描述

检查与服务器的连接是否正常。如果连接断开并启用了自动重新连接,则会尝试重新连接。如果连接断开并禁用了自动重新连接,mysql_ping ()返回一个错误。

默认禁用“自动重新连接”功能。要启用它,调用mysql_options ()MYSQL_OPT_RECONNECT选择。有关详细信息,请参见部分5.4.50”mysql_options ()

mysql_ping ()可以被客户端使用,保持空闲一段时间,以检查服务器是否关闭了连接,并重新连接,如果必要的话。

如果mysql_ping ())确实会导致重新连接,但没有明确的指示。要确定是否发生重新连接,请调用mysql_thread_id ()在调用之前获取原始连接标识符mysql_ping (),然后调用mysql_thread_id ()再次查看标识符是否已经更改。

如果重新连接,连接的一些特征将被重置。有关这些特性的详细信息,请参见3.6.6,“自动重连控制”

返回值

如果到服务器的连接是活动的,则为零。如果发生错误,则为非零。非零返回值并不表示MySQL服务器本身是否关闭;连接可能因其他原因中断,如网络问题。

错误