360智能路由器插件开发指南

10

♦ 件 插件  API

.1.API 的返回值 的返回值

API 调用出错时，将返回负值。错误码定义如下：

enum {

ERR_FAILURE= -1, /* 一般错误，如参数不合法 */

ERR_GROUP =-2, /* 用户组 ID非法*/

ERR_NO_RESOURCE= -3， /* 资源不可用*/

ERR_RULE_FULL =-4, /* 规则已满*/

ERR_NO_PERMISSION =-5,/* 无权限*/

ERR_NO_MEM = -6, /* 内存分配失败*/

ERR_NAME_EXIST = – 7, /* 名称已存在*/

ERR_NON_EXIST =-8, /* 规则不存在 */

ERR_DATA_ERR = -9, /* 参数错误*/

ERR_EXIST =-10, /* 规则已经存在*/

ERR_NOT_SUPPORT= -11, /* 不支持 */

};

2. 用户组

用户组是内网用户的集合，可以是 IP 地址集合或用户帐号集合。系统支持 256个用户组，系统保留了前 50个用户组，用于向插件提供预定义的用户分类，例如有线用户组、无线用户组，插件能引用这些组来进行规则设置。详见用户组 API 说明。

♦♦ 系统预留用户组

系统预留 50 个用户组（ID 为 0 至 49），插件程序可以引用，但不能操作它们。

在主机上下线时，主机依据所属的类别自动加入或退出相应系统用户组。目前定义的系统用户组如下表：

用户组编号 名称 解释

0(UGRP_ALL)

全部用户组 所有上网用户都属于该组

1(UGRP_IPMAC) MAC 绑定用户组

进行了 IP、ARP 协议的源MAC 地址绑定操作的用户

2(UGRP_IPMAC_IVS) MAC 未绑定用户组

未进行 IP、ARP 协议的源MAC 地址绑定操作的用户