跳转到正文
功能类

查询用户资料卡

get_summary_card:查询指定 QQ 号(含自身或陌生人)的资料卡。

const SummaryCardResult *get_summary_card(uint64_t self_id, const char *platform, uint64_t user_id);
void free_summary_card_result(const SummaryCardResult *result);
  • 权限:get_summary_card
  • 调用要求:需要账号在线,请在工作线程中调用

参数

参数类型必填说明
self_iduint64_t是在线 Bot QQ 号
platformconst char *是所属平台 PLATFORM_*
user_iduint64_t是目标 QQ 号,传 0 查询 Bot 自身;目标也可以是陌生人

返回值 SummaryCardResult

失败时 code == RESULT_LOCAL_ERROR,不要使用资料字段。用完必须调用 free_summary_card_result(result) 交还。

字段类型说明
codeint32_t0 表示成功
errorconst char *失败原因
user_iduint64_t查询到的 QQ 号
nicknameconst char *昵称
remarkconst char *备注
levelint64_tQQ 等级,无数据时为 0
like_countint64_t名片赞数,无数据时为 0
sexint64_t性别标记;未定义的值按未知处理,不猜测
ageint64_t年龄,无数据时为 0
signatureconst char *个性签名

本页目录