#yacConnect

# 功能简介

yacConnect函数用于客户端发起连接请求,返回YAC_SUCCESS表示连接成功,返回YAC_ERROR表示连接失败。

# 函数声明

yacResult yacConnect ( yacHandle hConn,
                       const yacChar* url,
                      YacInt16 urlLength,
                      const yacChar* user,
                      YacInt16 userLength,
                      const yacChar* password,
                      YacInt16 passwordLength);

# 参数说明

参数名 说明
hConn (IN/OUT) 连接信息句柄。
url (IN) 服务端的监听地址。格式如下:
* 单机/单IP模式: host:port;
* HA多IP primary模式:host:port,host:port,host:port或者 PRIMARY:host:port,host:port,host:port
* 多IP loadBalance模式:LOADBALANCE:host:port,host:port,host:port
参数含义:
* host:服务器域名或IP地址,需配置为单机实例服务器地址或分布式服务器地址;
* port:数据库服务端口,如1688。
* primary:该关键字表示多IP下采用primary模式连接,为多IP的默认模式,可省略此关键字。该模式下会轮询连接HA主库不连接备库。
* loadBalance:该关键字表示多IP下采用loadBalance模式连接。该模式下会连接最优节点(连接个数最少的节点)。
urlLength (IN) 服务端地址长度,可传入YAC_NULL_TERM_STR表示以\0结尾。
user (IN) 用户名。
userLength (IN) 用户名长度,可传入YAC_NULL_TERM_STR表示以\0结尾。
password (IN) 用户密码。
passwordLength (IN) 用户密码长度,可传入YAC_NULL_TERM_STR表示以\0结尾。
pdf-btn 下载文档
copy-btn 复制链接