发送数据 - TcpClientSend

函数简介

发送数据（异步操作）。

接口名称

TcpClientSend

DLL调用

int32_t TcpClientSend(int64_t instance, int64_t client_handle, int64_t data, int32_t data_len)

参数说明

参数名	类型	说明
instance	int64_t	OLAPlug对象的指针
client_handle	int64_t	客户端句柄
data	int64_t	数据指针
data_len	int32_t	数据长度

示例

// 发送字符串
const char* message = "Hello Server";
int32_t result = TcpClientSend(instance, client, (int64_t)message, strlen(message));
if (result == 1) {
    printf("数据已加入发送队列\n");
}

// 发送二进制数据
unsigned char buffer[1024];
// ... 填充buffer ...
result = TcpClientSend(instance, client, (int64_t)buffer, 1024);

// 在回调中发送数据
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) {  // 连接成功
        const char* msg = "Hello";
        TcpClientSend(instance, client_handle, (int64_t)msg, strlen(msg));
    } else if (event_type == 2) {  // 收到数据
        printf("收到：%.*s\n", data_len, (char*)data);
        
        // 回复
        const char* reply = "OK";
        TcpClientSend(instance, client_handle, (int64_t)reply, strlen(reply));
    }
}

返回值

返回值	说明
0	失败
1	成功加入发送队列

注意事项

• 这是异步操作，数据会被加入发送队列
• 发送完成后会触发回调（event_type=4）
• 如果启用了分包协议，会自动添加4字节长度前缀
• 如果未连接，发送会失败
• 数据会被复制，调用后可以立即释放原始数据