跳转到正文
功能类

设置群成员名片

set_group_member_name:设置或清除指定群成员的群名片。

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

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*
group_iduint64_t是群号,当前支持 1..UINT32_MAX
user_iduint64_t是目标成员 QQ 号;尚未取得该成员信息时可先 list_friends 或在收到其消息后操作
nameconst char *否群名片,传 "" 或 NULL 清除

返回值 SetGroupMemberNameResult

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

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

本页目录