跳转到正文
功能类

查询群资料

get_group_info:查询指定群号的完整群资料(不要求已加群)。

const GroupInfoResult *get_group_info(uint64_t self_id, const char *platform, uint64_t group_id);
void free_group_info_result(const GroupInfoResult *result);
  • 权限:get_group_info
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*
group_iduint64_t是群号,不能为 0;不要求账号已加入该群

返回值 GroupInfoResult

has_group_info == 1 时群资料字段有效,为 0 时为默认值;所有字符串均非 NULL,无内容时为 ""。用完必须调用 free_group_info_result(result) 交还。

字段类型说明
codeint32_t0 表示成功;服务器拒绝时原样返回服务端结果码,本地失败为 RESULT_LOCAL_ERROR
errorconst char *失败原因
group_iduint64_t本次查询的群号
is_in_groupuint8_t账号是否已在群内(0/1)
is_member_inviteuint8_t是否为成员邀请场景(0/1)
group_locationconst char *群位置
auth_group_infoconst char *入群认证信息
join_questionconst char *入群问题
join_answerconst char *入群答案
group_join_limit_typeuint64_t入群限制类型,具体值由服务端定义
has_group_infouint8_t是否取得群资料(0/1)
group_typeuint8_t群类型值(has_group_info == 1 时有效)
create_timeuint64_t创建时间,Unix 秒(has_group_info == 1 时有效)
group_flaguint64_t服务端群标记值,SDK 不定义位含义
owner_user_iduint64_t群主 QQ 号(has_group_info == 1 时有效)
group_optionuint8_t服务端群选项值,SDK 不定义位含义
group_class_extuint64_t服务端群分类扩展值,SDK 不定义位含义
member_maxuint64_t成员上限(has_group_info == 1 时有效)
special_classuint16_t服务端特殊分类值,SDK 不定义位含义
group_flag_extuint64_t服务端扩展标记值,SDK 不定义位含义
nameconst char *群名称(has_group_info == 1 时有效)
faceuint16_t群头像标识(has_group_info == 1 时有效)
memoconst char *群简介(has_group_info == 1 时有效)
member_countuint64_t成员数(has_group_info == 1 时有效)

本页目录