连接服务器 - TcpClientConnect

函数简介

连接到服务器（异步操作，结果通过回调通知）。

接口名称

TcpClientConnect

DLL调用

int32_t TcpClientConnect(int64_t instance, int64_t client_handle, const char* host, int32_t port)

参数说明

参数名类型说明
instanceint64_tOLAPlug对象的指针
client_handleint64_t客户端句柄
hoststring主机名或IP地址
portint32_t端口号

示例

// 连接到本地服务器
int32_t result = TcpClientConnect(instance, client, "127.0.0.1", 8080);
if (result == 1) {
    printf("开始连接...\n");
    // 连接结果会通过回调通知
}

// 连接到远程服务器
result = TcpClientConnect(instance, client, "192.168.1.100", 9000);

// 使用域名连接
result = TcpClientConnect(instance, client, "example.com", 80);

// 完整示例
void OnTcpClientEvent(int64_t client_handle, int32_t event_type, 
                      int64_t data, int32_t data_len, int64_t user_data) {
    if (event_type == 0) {
        printf("连接成功\n");
    } else if (event_type == 1) {
        printf("连接失败\n");
    }
}

int64_t client = TcpClientCreate(instance, OnTcpClientEvent, 0, 1);
if (client != 0) {
    if (TcpClientConnect(instance, client, "127.0.0.1", 8080) == 1) {
        printf("正在连接...\n");
    } else {
        printf("连接请求失败\n");
    }
}

返回值

返回值说明
0失败（参数错误等）
1开始连接（最终结果通过回调通知）

注意事项

  • 这是异步操作，函数立即返回
  • 连接结果通过回调函数通知（event_type=0成功，event_type=1失败）
  • 支持IPv4和IPv6地址
  • 支持域名解析
  • 如果已经连接，再次调用会失败
Last Updated: