#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结尾。 |