# PQsetdbLogin
#### 功能描述
与数据库服务器建立一个新的连接。
#### 原型
```
PGconn *PQsetdbLogin(const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbName,
                     const char *login,
                     const char *pwd);
```
#### 参数
表1PQsetdbLogin参数 
| **关键字**   | **参数说明**                                                                                                                                                  |
|:---|:---|
| pghost    | 要连接的主机名，详见[连接参数说明](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0221.html#ZH-CN_TOPIC_0000002186175590)章节描述的host字段。             |
| pgport    | 主机服务器的端口号，详见[连接参数说明](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0221.html#ZH-CN_TOPIC_0000002186175590)描述的port字段。             |
| pgoptions | 添加命令行选项以在运行时发送到服务器，详见[连接参数说明](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0221.html#ZH-CN_TOPIC_0000002186175590)描述的options字段。 |
| pgtty     | 忽略（这个选项声明服务器日志的输出方向）。                                                                                                                                     |
| dbName    | 要连接的数据库名，详见[连接参数说明](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0221.html#ZH-CN_TOPIC_0000002186175590)描述的dbname字段。            |
| login     | 要连接的用户名，详见[连接参数说明](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0221.html#ZH-CN_TOPIC_0000002186175590)章节描述的user字段。             |
| pwd       | 如果服务器要求口令认证，所用的口令，详见[连接参数说明](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0221.html#ZH-CN_TOPIC_0000002186175590)描述的password字段。 |
   
#### 返回值
PGconn \*：指向包含链接的对象指针，内存在函数内部申请。
#### 注意事项
- 该函数为PQconnectdb前身，参数个数固定，未定义参数被调用时使用缺省值，若需要给固定参数设置缺省值，则可赋值NULL或者空字符串。
- 若dbName中包含"="或连接URL的有效前缀，则该dbName被看做一个conninfo字符串并传递至PQconnectdb中，其余参数与PQconnectdbParams保持一致。
 
#### 示例
请参见[典型应用开发示例](https://support.huaweicloud.com/centralized-devg-v2-gaussdb/gaussdb_42_0142.html#ZH-CN_TOPIC_0000002186175510)章节。