跳转到正文
功能类

获取群聊列表

list_groups:获取在线账号加入的全部群聊(不分页)。

const GroupList *list_groups(uint64_t self_id, const char *platform);
void free_groups(const GroupList *list);
  • 权限:list_groups
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*

返回值 GroupList

一次返回全部群聊,不分页;失败时 count == 0。用完必须调用 free_groups(list) 交还。

字段类型说明
codeint32_t0 表示成功
errorconst char *失败原因
countuint32_t群数量
itemsGroup[]群数组

Group

字段类型说明
group_iduint64_t群号
member_countuint64_t成员数
member_maxuint64_t成员上限
create_timeuint64_t创建时间(Unix 秒)
nameconst char *群名称
remarkconst char *群备注
descriptionconst char *群简介
questionconst char *入群问题
announcementconst char *群公告

本页目录