跳转到正文
功能类

设置群成员专属头衔

set_group_special_title:设置或清除群成员的专属头衔。

const SetGroupSpecialTitleResult *set_group_special_title(
    uint64_t self_id, const char *platform, uint64_t group_id,
    uint64_t user_id, const char *title);
void free_set_group_special_title_result(const SetGroupSpecialTitleResult *result);
  • 权限:set_group_special_title
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*
group_iduint64_t是群号
user_iduint64_t是目标成员 QQ 号
titleconst char *否专属头衔,传 "" 或 NULL 清除;此接口不提供有效期选项

返回值 SetGroupSpecialTitleResult

用完必须调用 free_set_group_special_title_result(result) 交还。

字段类型说明
codeint32_t0 表示成功;服务器拒绝时原样保留服务端结果码,本地失败为 RESULT_LOCAL_ERROR(-1)
errorconst char *失败原因,非 NULL,无内容时为 ""

本页目录