连接服务器 - TcpClientConnect
函数简介
连接到服务器(异步操作,结果通过回调通知)。
接口名称
TcpClientConnect
DLL调用
int32_t TcpClientConnect(int64_t instance, int64_t client_handle, const char* host, int32_t port);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| client_handle | 长整数型 | 客户端句柄 |
| host | 字符串 | 主机名或IP地址 |
| port | 整数型 | 端口号 |
示例
// 连接到本地服务器
int32_t result = TcpClientConnect(instance, client, "127.0.0.1", 8080);
if (result == 1) {
printf("开始连接...\n");
// 连接结果会通过回调通知
}
返回值
整数型,1 成功(开始连接,最终结果通过回调通知),0 失败。
注意事项
- 这是异步操作,函数立即返回
- 连接结果通过回调函数通知(event_type=0成功,event_type=1失败)
- 支持IPv4和IPv6地址
- 支持域名解析
- 如果已经连接,再次调用会失败
