文档首页/ 云数据库 GaussDB/ 开发指南（主备版_2.x）/ 接口参考/ libpq/ 数据库连接控制函数/ PQconnectdbParams
更新时间：2023-10-23 GMT+08:00
查看PDF
分享

PQconnectdbParams

功能描述

与数据库服务器建立一个新的连接。

原型

1
2
3
 
PGconn *PQconnectdbParams(const char * const *keywords,
                          const char * const *values,
                          int expand_dbname);

参数

表1 PQconnectdbParams参数

关键字

参数说明

keywords

定义为一个字符串的数组，每个都成为一个关键字。

values

给每个关键字一个值。

expand_dbname

当expand_dbname是非零的时，允许将dbname的关键字值看做一个连接字符串。只有第一个出现的dbname是这样展开的，任何随后的dbname值作为纯数据库名处理。

返回值

PGconn *：指向包含链接的对象指针，内存在函数内部申请。

注意事项

这个函数用从两个NULL结束的数组中来的参数打开一个新的数据库连接。与PQsetdbLogin不同的是，可以不必更换函数签名（名字）就可以扩展参数集，所以建议应用程序中使用这个函数（或者它的类似的非阻塞变种PQconnectStartParams和PQconnectPoll）。

示例

请参见示例章节。