GaussDB-PQconnectdbParams

41 阅读1分钟

GaussDB-PQconnectdbParams

功能描述

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

原型

| ``` PGconn* PQconnectdbParams(const char* const* keywords, const char* const* values, int expand_dbname);

| -------------------------------------------------------------------------------------------------------------- |

#### 参数

| **关键字**       | **参数说明**                                                                         |
| :------------ | :------------------------------------------------------------------------------- |
| keywords      | 定义为一个字符串的数组,每个都成为一个关键字。                                                          |
| values        | 给每个关键字一个值。                                                                       |
| expand_dbname | 当expand_dbname非零时,允许将dbname的关键字值看做一个连接字符串。只有第一个出现的dbname是这样,随后的dbname值作为纯数据库名处理。 |

#### 返回值

PGconn *:指向包含连接的对象指针,内存在函数内部申请。

#### 注意事项

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

更多详情请参考GaussDB 文档中心:<https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html>