int mysql_ping(MYSQL *mysql)

Описание

Проверки, работает ли соединение с сервером. Если соединение потеряло работоспособность и % автоповторно соединяется, включается, попытка повторно соединиться предпринимается. Если соединение снижается, и % автоповторно соединитесь, отключается, mysql_ping() возвращает ошибку.

% автоповторно соединитесь отключается по умолчанию. Чтобы включить этому, вызвать mysql_options() с MYSQL_OPT_RECONNECT опция. Для получения дополнительной информации см. Раздел 22.8.7.49,"mysql_options()".

mysql_ping() может использоваться клиентами, которые остаются неактивными долгое время, чтобы проверить, закрыл ли сервер соединение и повторно соединяется в случае необходимости.

Если mysql_ping()) действительно вызывает повторно соединение, нет никакой явной индикации относительно него. Чтобы определить, происходит ли повторно соединение, вызвать mysql_thread_id() получить исходный идентификатор соединения перед вызовом mysql_ping(), тогда вызовите mysql_thread_id() снова, чтобы видеть, изменился ли идентификатор.

Если повторно соединяются, происходит, некоторые характеристики соединения будут сброшены. Для получения дополнительной информации об этих характеристиках, см. Раздел 22.8.16, "Управляя Автоматическим Поведением Пересоединения".

Возвращаемые значения

Нуль, если соединение с сервером является активным. Ненулевой, если ошибка произошла. Ненулевой возврат не указывает, снижается ли сервер самого MySQL; соединение могло бы быть повреждено по другим причинам, таким как сетевые проблемы.

Ошибки