返回该连接的数据库名。

char *PQdb(const PGconn *conn);

返回该连接的用户名。

char *PQuser(const PGconn *conn);

返回该连接的密码。

char *PQpass(const PGconn *conn);

返回连接的服务器主机名。可能是主机名、IP 地址或者一个目录路径（如果通过 Unix 套接字连接）。

char *PQhost(const PGconn *conn);

返回连接的端口。

char *PQport(const PGconn *conn);

返回该连接用于调试的TTY。（此功能已过时，因为服务器不再使用TTY设置，但为保持向后兼容仍保留此函数。）

char *PQtty(const PGconn *conn);

返回连接请求中传递的命令行选项。

char *PQoptions(const PGconn *conn);

返回该连接的状态。

ConnStatusType PQstatus(const PGconn *conn);

该状态可以是一系列值之一。不过，其中只有两个在一个异步连接过程之外可见：CONNECTION_OK和CONNECTION_BAD。 一个到数据库的完好连接的状态为CONNECTION_OK。一个失败的连接尝试则由状态CONNECTION_BAD表示。 通常，一个 OK 状态将一直保持到PQfinish，但是一次通信失败可能导致该状态过早地改变为CONNECTION_BAD。 在那种情况下，该应用可以通过调用PQreset尝试恢复。

关于其他可能会被返回的状态代码，请见PQconnectStartParams、PQconnectStart和PQconnectPoll的条目。

返回服务器的当前事务内状态。

PGTransactionStatusType PQtransactionStatus(const PGconn *conn);

该状态可能是PQTRANS_IDLE（当前空闲）、PQTRANS_ACTIVE（一个命令运行中）、PQTRANS_INTRANS（空闲，处于一个有效的事务块中）或者PQTRANS_INERROR（空闲，处于一个失败的事务块中）。如果该连接异常，将会报告PQTRANS_UNKNOWN。只有当一个查询已经被发送给服务器并且还没有完成时，才会报告PQTRANS_ACTIVE。

查找服务器某个参数的当前设置。

const char *PQparameterStatus(const PGconn *conn, const char *paramName);

服务器会在连接启动时，以及某些参数值发生变化时，自动报告这些参数值。PQparameterStatus可用于查询这些设置。如果已知该参数，则返回其当前值；如果未知，则返回NULL。

截至当前发行版本会报告的参数包括server_version、server_encoding、client_encoding、application_name、is_superuser、session_authorization、DateStyle、IntervalStyle、TimeZone、integer_datetimes和standard_conforming_strings。（server_encoding、TimeZone和integer_datetimes在 8.0 之前的发行中不被报告；standard_conforming_strings在 8.1 之前的发行中不被报告；IntervalStyle在 8.4 之前的发行中不被报告；application_name在 9.0 之前的发行中不被报告。）注意server_version、server_encoding和integer_datetimes在启动后不能改变。

3.0 之前协议的服务器不报告参数设置，但libpq包含了为server_version和client_encoding获取值的逻辑。鼓励应用使用PQparameterStatus而不是ad hoc代码来确定这些值。（但要注意，在 3.0 之前的连接上，连接启动之后通过SET修改client_encoding不会被PQparameterStatus反映。）对于server_version，另见PQserverVersion，它以一种更容易比较的数字形式返回该信息。

如果没有报告standard_conforming_strings的值，应用可以假定它是off，即在字符串字面量中反斜线被当作转义符。此外，这个参数的存在可以被当作接受转义字符串语法（E'...'）的一个标志。

返回的指针虽然被声明为const，但实际上指向与PGconn结构体关联的可变存储。不能假定该指针在执行其他查询后仍然有效。

查询正在使用的前端/后端协议。

int PQprotocolVersion(const PGconn *conn);

应用程序可以使用此函数判断是否支持某些特性。目前，可能的值为 2（协议 2.0）、3（协议 3.0）或零（连接异常）。连接启动完成后，协议版本不会改变，但理论上可能在连接重置期间改变。通常，与 PostgreSQL 7.4 或更高版本的服务器通信时使用协议 3.0；7.4 之前的服务器仅支持协议 2.0。（协议 1.0 已过时，libpq 不支持它。）

返回一个表示后端版本的整数。

int PQserverVersion(const PGconn *conn);

应用可能会使用这个函数来判断它们连接到的数据库服务器的版本。这个数字是这样形成的：将主版本、次版本和修订版本号分别转换成两位十进制数，然后把它们拼接在一起。例如，版本8.1.5将被返回为80105，而版本8.2将被返回为80200（不显示前导零）。如果连接无效则返回零。

返回连接上的一个操作最近产生的错误消息。

char *PQerrorMessage(const PGconn *conn);

几乎所有 libpq 函数在失败时都会设置一条供 PQerrorMessage 返回的消息。注意，按照 libpq 的约定，非空的 PQerrorMessage 结果可能包含多行，并以换行符结尾。调用者不应直接释放该结果；当关联的 PGconn 句柄被传给 PQfinish 时，结果会被释放。不能假定在对 PGconn 结构体执行其他操作后，结果字符串仍保持不变。

获取与服务器相连的套接字的文件描述符编号。有效描述符大于或等于 0。结果为 -1 表示当前没有打开服务器连接（在普通操作期间这将不会改变，但是在连接设置或重置期间可能改变）。

int PQsocket(const PGconn *conn);

返回处理这个连接的后端进程的进程ID（PID）。

int PQbackendPID(const PGconn *conn);

后端 PID 可用于调试，也可与 NOTIFY 消息进行比较（消息包含发出通知的后端进程的 PID）。注意，该 PID 属于在数据库服务器主机上运行的进程，而非本地主机上的进程！

如果连接认证方法要求一个密码但没有可用的密码，返回真（1）。否则返回假（0）。

int PQconnectionNeedsPassword(const PGconn *conn);

这个函数可以在连接尝试失败后被应用于决定是否向用户提示要求一个密码。

如果连接认证方法使用一个密码，返回真（1）。否则返回假（0）。

int PQconnectionUsedPassword(const PGconn *conn);

这个函数能在一次连接尝试失败或成功后用于检测该服务器是否要求一个密码。

返回在连接中使用的SSL结构体，如果未使用SSL，则返回NULL。

SSL *PQgetssl(const PGconn *conn);

该结构体可以用来验证加密级别、检查服务器证书等。有关此结构体的信息，请参阅 OpenSSL文档。

必须定义 USE_SSL 才能得到这个函数正确的原型。这样做还会自动包含来自OpenSSL的ssl.h。