PQpingParams

功能描述

PQpingParams报告服务器的状态。它接受和PQconnectdbParams 一样的连接参数。获取服务器状态不需要提供正确的用户名、密码或数据库名的值，但若给定了错误值，服务器将记录一次失败的连接尝试。

PGPing PQpingParams(const char * const *keywords,
                    const char * const *values,
                    int expand_dbname);

接口原型中所有参数与PQconnectdbParams 中的同名参数意义完全一致，此处不再赘述。

该函数返回下列的值之一：

返回值	说明
PQPING_OK	服务器正在运行并且似乎接受了连接。
PQPING_REJECT	服务器正在运行，但是在一个不允许连接的状态（启动、关闭或崩溃恢复）。
PQPING_NO_RESPONSE	联系不上服务器。这可能表明服务器没有运行，或者给出的连接参数有什么错误（例如，错误的端口号），或者网络连接有问题（例如，防火墙阻塞连接请求）。
PQPING_NO_ATTEMPT	没有尝试连接到服务器，因为提供的参数明显的不正确或者有一些客户端侧的问题（例如，内存溢出）。

无。