# PQstatus
#### 功能描述
返回连接的状态。
#### 原型
```
ConnStatusType PQstatus(const PGconn *conn);
```
#### 参数
表1PQstatus参数 
| **关键字** | **参数说明**     |
|:---|:---|
| conn    | 指向包含连接的对象指针。 |
   
#### 返回值
ConnStatusType：连接状态的枚举，包括：
```
CONNECTION_STARTED
等待进行连接。
CONNECTION_MADE
连接成功；等待发送。
CONNECTION_AWAITING_RESPONSE
等待来自服务器的响应。
CONNECTION_AUTH_OK
已收到认证；等待后端启动结束。
CONNECTION_SSL_STARTUP
协商SSL加密。
CONNECTION_SETENV
协商环境驱动的参数设置。
CONNECTION_OK
连接正常。
CONNECTION_BAD
连接故障。
```
#### 注意事项
状态可以是多个值之一。但是，在异步连接过程之外只能看到其中两个：CONNECTION_OK和CONNECTION_BAD。与数据库的良好连接状态为CONNECTION_OK，与数据库连接失败状态为CONNECTION_BAD。通常，"正常"状态将一直保持到PQfinish，但通信失败可能会导致状态过早变为CONNECTION_BAD。在这种情况下，应用程序可以尝试通过调用进行恢复PQreset。
#### 示例
请参见[典型应用开发示例](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-1532.html#ZH-CN_TOPIC_0000002200418566)章节。