功能类
查询群资料
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_id | uint64_t | 是 | 在线 Bot QQ 号 |
platform | const char * | 是 | 所属平台 PLATFORM_* |
group_id | uint64_t | 是 | 群号,不能为 0;不要求账号已加入该群 |
返回值 GroupInfoResult
has_group_info == 1 时群资料字段有效,为 0 时为默认值;所有字符串均非 NULL,无内容时为 ""。用完必须调用 free_group_info_result(result) 交还。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;服务器拒绝时原样返回服务端结果码,本地失败为 RESULT_LOCAL_ERROR |
error | const char * | 失败原因 |
group_id | uint64_t | 本次查询的群号 |
is_in_group | uint8_t | 账号是否已在群内(0/1) |
is_member_invite | uint8_t | 是否为成员邀请场景(0/1) |
group_location | const char * | 群位置 |
auth_group_info | const char * | 入群认证信息 |
join_question | const char * | 入群问题 |
join_answer | const char * | 入群答案 |
group_join_limit_type | uint64_t | 入群限制类型,具体值由服务端定义 |
has_group_info | uint8_t | 是否取得群资料(0/1) |
group_type | uint8_t | 群类型值(has_group_info == 1 时有效) |
create_time | uint64_t | 创建时间,Unix 秒(has_group_info == 1 时有效) |
group_flag | uint64_t | 服务端群标记值,SDK 不定义位含义 |
owner_user_id | uint64_t | 群主 QQ 号(has_group_info == 1 时有效) |
group_option | uint8_t | 服务端群选项值,SDK 不定义位含义 |
group_class_ext | uint64_t | 服务端群分类扩展值,SDK 不定义位含义 |
member_max | uint64_t | 成员上限(has_group_info == 1 时有效) |
special_class | uint16_t | 服务端特殊分类值,SDK 不定义位含义 |
group_flag_ext | uint64_t | 服务端扩展标记值,SDK 不定义位含义 |
name | const char * | 群名称(has_group_info == 1 时有效) |
face | uint16_t | 群头像标识(has_group_info == 1 时有效) |
memo | const char * | 群简介(has_group_info == 1 时有效) |
member_count | uint64_t | 成员数(has_group_info == 1 时有效) |