跳转到正文
账号管理

修改自身昵称

set_nickname:修改在线账号自身的 QQ 昵称。

const SetNicknameResult *set_nickname(uint64_t self_id, const char *platform, const char *nickname);
void free_set_nickname_result(const SetNicknameResult *result);
  • 权限:set_nickname
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号,当前支持 1..UINT32_MAX
platformconst char *是所属平台 PLATFORM_*
nicknameconst char *是UTF-8 新昵称(非群名片或备注);去空白后不能为空,最多 36 个 UTF-8 字节

返回值 SetNicknameResult

用完必须调用 free_set_nickname_result(result) 交还。返回成功不表示账号列表已即时刷新,可通过 nickname_changed 事件确认更新。若随后收到资料保存失败提示,请检查本地目录是否可写,原接口结果不因此改变。

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

本页目录