跳转到正文
登录验证

获取协议列表

list_protocols:查询当前客户端支持的协议标识。

const StringList *list_protocols(void);
void free_strings(const StringList *list);
  • 权限:list_protocols
  • 调用要求:无需账号在线

使用说明

  • 返回的字符串(如 "qq_phone"、"tim_pad")可直接传给 add_account / edit_account 的 protocol 参数。
  • 头文件中的 PROTOCOL_* 常量不一定全部受当前客户端支持,请以本接口返回结果为准。
  • 失败时返回 NULL;用完必须调用 free_strings(list) 交还。

头文件预定义协议常量

以下常量定义于 plugin.h,但不代表当前客户端一定支持全部协议,调用前请以 list_protocols() 的实际返回结果为准:

常量值说明
PROTOCOL_QQ_PHONE"qq_phone"QQ 手机
PROTOCOL_QQ_PAD"qq_pad"QQ 平板
PROTOCOL_TIM_PHONE"tim_phone"TIM 手机
PROTOCOL_TIM_PAD"tim_pad"TIM 平板
PROTOCOL_QQ_WATCH"qq_watch"QQ 手表

返回值 StringList

字段类型说明
countuint32_t协议数量
itemsconst char *const *UTF-8 协议标识数组

本页目录