获取所有连接ID - TcpServerGetAllConnectionIds

函数简介

获取所有连接的ID列表。

接口名称

TcpServerGetAllConnectionIds

DLL调用

const char* TcpServerGetAllConnectionIds(int64_t instance, int64_t server_handle)

参数说明

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

示例

// 获取所有连接ID
const char* connIds = TcpServerGetAllConnectionIds(instance, server);
if (connIds != NULL) {
    printf("连接ID列表：%s\n", connIds);  // 输出：1,2,3
    FreeStringPtr(instance, connIds);
}

// 遍历所有连接
void ProcessAllConnections(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);
            
            // 获取客户端地址
            const char* addr = TcpServerGetClientAddress(instance, server, conn_id);
            if (addr != NULL) {
                printf("连接[%lld]：%s\n", conn_id, addr);
                FreeStringPtr(instance, addr);
            }
            
            token = strtok(NULL, ",");
        }
        
        free(ids);
        FreeStringPtr(instance, connIds);
    }
}

// 统计连接数
int32_t GetConnectionCount(int64_t server) {
    int32_t count = 0;
    const char* connIds = TcpServerGetAllConnectionIds(instance, server);
    
    if (connIds != NULL && strlen(connIds) > 0) {
        char* ids = strdup(connIds);
        char* token = strtok(ids, ",");
        
        while (token != NULL) {
            count++;
            token = strtok(NULL, ",");
        }
        
        free(ids);
        FreeStringPtr(instance, connIds);
    }
    
    return count;
}

返回值

返回值类型	说明
string	连接ID列表字符串指针，需调用FreeStringPtr释放，失败返回NULL

注意事项

• 返回的字符串需要调用 FreeStringPtr 释放内存
• 返回格式：连接ID之间用逗号分隔，如"1,2,3"
• 如果没有连接，返回空字符串""
• 可用于广播消息、统计连接数等