PQstatus

功能描述

返回链接的状态。

原型

  1. ConnStatusType PQstatus(const PGconn *conn);

参数

表 1 PQstatus参数

关键字

参数说明

conn

指向包含链接的对象指针。

返回值

ConnStatusType：链接状态的枚举，包括：

  1. CONNECTION_STARTED
  2. 等待进行连接。
  4. CONNECTION_MADE
  5. 连接成功；等待发送。
  7. CONNECTION_AWAITING_RESPONSE
  8. 等待来自服务器的响应。
  10. CONNECTION_AUTH_OK
  11. 已收到认证；等待后端启动结束。
  13. CONNECTION_SSL_STARTUP
  14. 协商SSL加密。
  16. CONNECTION_SETENV
  17. 协商环境驱动的参数设置。
  19. CONNECTION_OK
  20. 链接正常。
  22. CONNECTION_BAD
  23. 链接故障。

注意事项

状态可以是多个值之一。但是，在异步连接过程之外只能看到其中两个：CONNECTION_OK和CONNECTION_BAD。与数据库的良好连接状态为CONNECTION_OK。与数据库的连接尝试失败为CONNECTION_BAD。通常，“正常”状态将一直保持到PQfinish，但通信失败可能会导致状态CONNECTION_BAD过早变为。在这种情况下，应用程序可以尝试通过调用进行恢复PQreset。

示例

请参见示例章节。