跳转到正文
功能类

获取好友列表

list_friends:分页获取在线账号的好友列表。

const FriendList *list_friends(uint64_t self_id, const char *platform, uint64_t next_user_id);
void free_friends(const FriendList *list);
  • 权限:list_friends
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*
next_user_iduint64_t是分页起点:第一页传 0,之后传上一页返回的 next_user_id

返回值 FriendList

每页最多 300 个好友;next_user_id == 0 表示已是最后一页,失败时 count == 0。用完必须调用 free_friends(list) 交还。

字段类型说明
codeint32_t0 表示成功
errorconst char *失败原因
totaluint64_t好友总数
next_user_iduint64_t下一页起点,0 表示无更多
countuint32_t本页好友数
itemsFriend[]好友数组

Friend

字段类型说明
user_iduint64_tQQ 号
category_iduint64_t好友分组编号
nicknameconst char *昵称
remarkconst char *备注
signatureconst char *个性签名

本页目录