返回连接的数据库名称。

char *PQdb(const PGconn *conn);

返回连接的用户名称。

char *PQuser(const PGconn *conn);

返回连接的密码。

char *PQpass(const PGconn *conn);

PQpass 将返回连接参数中指定的密码，或者如果没有密码并且密码是从密码文件中获取的，则将返回该密码。在后一种情况下，如果在连接参数中指定了多个主机，则在建立连接之前无法依赖 PQpass 的结果。可以使用函数 PQstatus 检查连接的状态。

返回活动连接的服务器主机名。这可以是主机名、IP地址或目录路径（如果连接是通过 Unix 套接字）。（路径情况可以通过它始终是绝对路径，以 / 开头来区分。）

char *PQhost(const PGconn *conn);

如果连接参数同时指定了 host 和 hostaddr，则 PQhost 将返回 host 信息。如果仅指定了 hostaddr，则返回该信息。如果在连接参数中指定了多个主机，则 PQhost 返回实际连接到的主机。

PQhost 如果 conn 参数为 NULL，则返回 NULL。否则，如果生成主机信息时出错（例如，如果连接尚未完全建立或发生错误），则返回空字符串。

如果在连接参数中指定了多个主机，则在建立连接之前无法依赖 PQhost 的结果。可以使用函数 PQstatus 检查连接的状态。

返回活动连接的服务器 IP 地址。这可以是主机名解析到的地址，也可以是通过 hostaddr 参数提供的 IP 地址。

char *PQhostaddr(const PGconn *conn);

PQhostaddr 如果 conn 参数为 NULL，则返回 NULL。否则，如果生成主机信息时出错（例如，如果连接尚未完全建立或发生错误），则返回空字符串。

返回活动连接的端口。

char *PQport(const PGconn *conn);

如果在连接参数中指定了多个端口，则 PQport 返回实际连接到的端口。

PQport 如果 conn 参数为 NULL，则返回 NULL。否则，如果生成端口信息时出错（例如，如果连接尚未完全建立或发生错误），则返回空字符串。

如果在连接参数中指定了多个端口，则在建立连接之前无法依赖 PQport 的结果。可以使用函数 PQstatus 检查连接的状态。

此函数不再执行任何操作，但为了向后兼容而保留。该函数始终返回空字符串，或者如果 conn 参数为 NULL，则返回 NULL。

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。

在当前版本中报告的参数包括

(在 14 之前的版本中未报告 default_transaction_read_only 和 in_hot_standby；在 16 之前的版本中未报告 scram_iterations。) 请注意，server_version、server_encoding 和 integer_datetimes 在启动后无法更改。

如果未报告 standard_conforming_strings 的值，应用程序可以假设其为 off，即在字符串文字中反斜杠被视为转义符。此外，此参数的存在可以被视为接受转义字符串语法（E'...'）的指示。

虽然返回的指针声明为 const，但它实际上指向与 PGconn 结构关联的可变存储。假设指针在查询之间保持有效是不明智的。

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

int PQprotocolVersion(const PGconn *conn);

应用程序可能希望使用此函数来确定是否支持某些功能。目前，可能的值为 3（3.0 协议）或零（连接错误）。协议版本在连接启动完成后不会更改，但在理论上可能会在连接重置期间更改。3.0 协议受 PostgreSQL 服务器版本 7.4 及更高版本支持。

返回一个整数，表示服务器版本。

int PQserverVersion(const PGconn *conn);

应用程序可以使用此函数来确定他们连接到的数据库服务器的版本。结果是通过将服务器的主版本号乘以 10000 并加上次版本号形成的。例如，版本 10.1 将返回为 100001，版本 11.0 将返回为 110000。如果连接错误，则返回零。

在 10 主版本之前，PostgreSQL 使用三部分版本号，其中前两部分一起表示主版本。对于这些版本，PQserverVersion 每个部分使用两位数字；例如版本 9.1.5 将返回为 90105，版本 9.2.0 将返回为 90200。

因此，为了确定功能兼容性，应用程序应将 PQserverVersion 的结果除以 100 而不是 10000 以确定逻辑主版本号。在所有发行系列中，只有最后两位数字在次要版本（错误修复版本）之间有所不同。

返回最近由连接上的操作生成的错误消息。

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属于在数据库服务器主机上执行的进程，而不是本地主机！

如果连接身份验证方法需要密码但没有可用密码，则返回 true (1)。否则返回 false (0)。

int PQconnectionNeedsPassword(const PGconn *conn);

此函数可以在连接尝试失败后应用，以决定是否提示用户输入密码。

如果连接身份验证方法使用了密码，则返回 true (1)。否则返回 false (0)。

int PQconnectionUsedPassword(const PGconn *conn);

此函数可以在连接尝试失败或成功后应用，以检测服务器是否要求密码。

如果连接身份验证方法使用了 GSSAPI，则返回 true (1)。否则返回 false (0)。

int PQconnectionUsedGSSAPI(const PGconn *conn);

此函数可以应用于检测连接是否使用 GSSAPI 进行身份验证。

如果连接使用 SSL，则返回 true (1)，否则返回 false (0)。

int PQsslInUse(const PGconn *conn);

返回有关连接的与 SSL 相关的信息。

const char *PQsslAttribute(const PGconn *conn, const char *attribute_name);

可用属性列表因使用的 SSL 库和连接类型而异。如果连接不使用 SSL 或指定的属性名称未在使用的库中定义，则返回 NULL。

以下属性通常可用

作为特殊情况，可以通过将 NULL 作为 conn 参数传递来查询 library 属性而无需连接。结果将是默认 SSL 库名称，或者如果 libpq 在没有 SSL 支持的情况下编译，则为 NULL。（在 PostgreSQL 版本 15 之前，将 NULL 作为 conn 参数传递始终导致 NULL。需要区分此案例的新旧实现的客户端程序可以检查 LIBPQ_HAS_SSL_LIBRARY_DETECTION 功能宏。）

返回一个可以在 PQsslAttribute() 中使用的 SSL 属性名称数组。该数组以 NULL 指针结尾。

const char * const * PQsslAttributeNames(const PGconn *conn);

如果 conn 为 NULL，则返回默认 SSL 库可用的属性，或者如果 libpq 在没有 SSL 支持的情况下编译，则返回空列表。如果 conn 不为 NULL，则返回连接使用的 SSL 库可用的属性，或者如果连接未加密，则返回空列表。

返回一个指向描述连接的 SSL 实现特定对象的指针。如果连接未加密或请求的对象类型在连接的 SSL 实现中不可用，则返回 NULL。

void *PQsslStruct(const PGconn *conn, const char *struct_name);

可用的结构取决于正在使用的 SSL 实现。对于 OpenSSL，有一个结构，在名称 OpenSSL 下可用，它返回指向 OpenSSL 的 SSL 结构的指针。要使用此函数，可以使用以下几行代码

#include <libpq-fe.h>
#include <openssl/ssl.h>

...

    SSL *ssl;

    dbconn = PQconnectdb(...);
    ...

    ssl = PQsslStruct(dbconn, "OpenSSL");
    if (ssl)
    {
        /* use OpenSSL functions to access ssl */
    }

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

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

void *PQgetssl(const PGconn *conn);

此函数等效于 PQsslStruct(conn, "OpenSSL")。不应在新的应用程序中使用它，因为返回的结构特定于 OpenSSL，并且如果使用其他SSL实现，则不可用。要检查连接是否使用 SSL，请改用 PQsslInUse，并有关连接的更多详细信息，请使用 PQsslAttribute。