跳转到正文
账号管理

获取账号列表

list_accounts:查询客户端已添加的全部账号。

const AccountList *list_accounts(void);
void free_accounts(const AccountList *list);
  • 权限:list_accounts
  • 调用要求:无需账号在线

使用说明

  • 失败时返回 NULL(原因见运行日志);返回空列表(count == 0)不是失败。
  • 遍历以 count 为准,count == 0 时不要读取 items。
  • 不要按列表位置关联账号,请使用 self_id 与 platform 定位目标账号。
  • 用完必须调用 free_accounts(list) 交还。

返回值 AccountList

字段类型说明
countuint32_t账号数量
itemsAccount[]账号数组

Account

字段类型说明
self_iduint64_tQQ 号
protocolconst char *当前协议 PROTOCOL_*,如 "tim_pad"
platformconst char *所属平台 PLATFORM_*("android" / "pc"),由协议决定
nicknameconst char *昵称
statusint32_t账号状态:ACCOUNT_OFFLINE(0)/ ACCOUNT_ONLINE(1)/ ACCOUNT_LOGGING_IN(2)/ ACCOUNT_RECONNECTING(3)
levelint32_tQQ 等级,未取到时为 -1
receiveduint64_t本次上线以来收到的聊天消息数,重连期间不清零
sentuint64_t本次上线以来成功发出的聊天消息数,不含系统事件
online_sinceuint64_t本次上线时间(Unix 秒),重连期间保留,不在线时为 0
noteconst char *附加信息,如断线原因

本页目录