GaussDB-PQsetdbLogin
功能描述
与数据库服务器建立一个新的连接。
原型
PGconn* PQsetdbLogin(const char* pghost, const char* pgport, const char* pgoptions, const char* pgtty,
const char* dbName, const char* login, const char* pwd);
参数
| 关键字 | 参数说明 |
|---|---|
| pghost | 要连接的主机名,请参见连接参数描述的host字段。 |
| pgport | 主机服务器的端口号,请参见连接参数描述的port字段。 |
| pgoptions | 添加命令行选项以在运行时发送到服务器,请参见连接参数描述的options字段。 |
| pgtty | 忽略(以前该选项声明服务器日志的输出方向) |
| dbName | 要连接的数据库名,请参见连接参数描述的dbname字段。 |
| login | 要连接的用户名,请参见连接参数描述的user字段。 |
| pwd | 如果服务器要求口令认证,所用的口令,请参见连接参数描述的password字段。 |
返回值
PGconn *:指向包含连接的对象指针,内存在函数内部申请。
注意事项
- 该函数为PQconnectdb前身,参数个数固定,未定义参数被调用时使用缺省值,若需要给固定参数设置缺省值,则可赋值NULL或者空字符串。
- 若dbName中包含“=”或连接URL的有效前缀,则该dbName被看做一个conninfo字符串并传递至PQconnectdb中,其余参数与PQconnectdbParams保持一致。
更多详情请参考GaussDB 文档中心:doc.hcs.huawei.com/db/zh-cn/ga…