账号管理
修改自身昵称
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_id | uint64_t | 是 | 在线 Bot QQ 号,当前支持 1..UINT32_MAX |
platform | const char * | 是 | 所属平台 PLATFORM_* |
nickname | const char * | 是 | UTF-8 新昵称(非群名片或备注);去空白后不能为空,最多 36 个 UTF-8 字节 |
返回值 SetNicknameResult
用完必须调用 free_set_nickname_result(result) 交还。返回成功不表示账号列表已即时刷新,可通过 nickname_changed 事件确认更新。若随后收到资料保存失败提示,请检查本地目录是否可写,原接口结果不因此改变。
| 字段 | 类型 | 说明 |
|---|---|---|
code | int32_t | 0 表示成功;服务器拒绝时原样保留服务端结果码,本地失败为 RESULT_LOCAL_ERROR(-1) |
error | const char * | 失败原因,非 NULL,无内容时为 "" |