断开指定连接 - TcpServerDisconnect

函数简介

断开指定的客户端连接。

接口名称

TcpServerDisconnect

DLL调用

int32_t TcpServerDisconnect(int64_t instance, int64_t server_handle, int64_t conn_id)

参数说明

参数名	类型	说明
instance	int64_t	OLAPlug对象的指针
server_handle	int64_t	服务端句柄
conn_id	int64_t	连接ID

示例

// 在回调中断开连接
void OnTcpServerEvent(int64_t server_handle, int64_t conn_id, int32_t event_type,
                      int64_t data, int32_t data_len, int64_t user_data) {
    if (event_type == 1) {  // 收到数据
        const char* msg = (char*)data;
        
        // 如果收到"quit"，断开该客户端
        if (strncmp(msg, "quit", 4) == 0) {
            printf("客户端请求断开[conn_id=%lld]\n", conn_id);
            TcpServerDisconnect(instance, server_handle, conn_id);
        }
    } else if (event_type == 2) {  // 连接断开
        printf("连接已断开[conn_id=%lld]\n", conn_id);
    }
}

// 断开所有连接
void DisconnectAllClients(int64_t server) {
    const char* connIds = TcpServerGetAllConnectionIds(instance, server);
    if (connIds != NULL) {
        char* ids = strdup(connIds);
        char* token = strtok(ids, ",");
        
        while (token != NULL) {
            int64_t conn_id = atoll(token);
            TcpServerDisconnect(instance, server, conn_id);
            token = strtok(NULL, ",");
        }
        
        free(ids);
        FreeStringPtr(instance, connIds);
    }
}

返回值

返回值	说明
0	失败
1	成功

注意事项

• 断开后会触发回调（event_type=2）
• 如果连接不存在，调用会失败
• 断开是异步操作，可能不会立即完成
• 断开后，conn_id失效