接口设计方案

接口设计方案

接口设计方案

一、设计方案

由甲方调用监控模块,控制监控模块的启停、设置策略等，经过甲方调用监控模块DLL的接口将监控策略告知监控模块，由监控模块监控相关操作行为，并根据策略配置调用甲方提供的文件内容检查模块，对相关文件进行文件内容筛查，来确定文件是否是涉密文件。同时经过甲方程序调用乙方监控模块DLL接口获取监控结果。

一、接口部分（监控模块DLL,乙方提供）

************************************

Function:Init

Description:初始化操作

Input:无

Output:无

Return：true：成功，false：失败

Other:

***********************************

1、bool Init();

************************************ Function:SetRule

Description:设置监控规则

Input:char* pRule：监控规则，XML格式，见附1 Output:无

Return：true：成功，false：失败

Other:

***********************************

2、bool SetRule(char* pRule);

************************************ Function:Start

Description:设置完规则，启动监控规则生效Input:无

Output:无

Return：true：成功，false：失败

Other:

***********************************

3、bool Start();

************************************

Function:WaitData

Description:实时等待获取监控数据能够是一条能够是多条。返回监控结果见附2

Input:无

Output: int &nCount返回总条数，char**&pData返回数据。Return：-1.异常0.成功获取数据1.结束 / 停止（其它地方调用Stop接口停止）

Other:建议乙方内部实现用信号、内核事件等处理方式。

***********************************

4、int WaitData(int &nCount, char**& pData);

甲方调用伪代码：

ThreadFunc() //实时线程

{

While(TRUE)

{

char** pData = NULL;

int nCount = 0;

int nRet = WaitData(nCount,pData); //等待一条或

多条数据时返回,没有数据就等待。

switch(nRet)

{

-1.异常continue;

0.成功获取数据 pData[0]、pData[1]、……

1.结束 / 停止（其它地方调用Stop停止） Return;

}

FreeData(pData);

}

}

************************************

Function:FreeData

Description:释放数据内存接口，对应WaitData函数Input:int nCount 要释放的元素数量，char**要释放的数据Output:无

Return：无

Other:

***********************************

5、FreeData (int nCount ,char** pData);

************************************