过时的 API

此部分包含以下主题：

eAC IR API

结构

可能的返回值

函数

eAC IR API

此库提供 CA ControlMinder 日志文件（seos.audit 和 seos.audit.bak）的接口。

通过此 API，外部应用程序可以按时间先后顺序查看审核记录。

重要说明！ 本附录中介绍的 API 已过时，仅用于满足向后兼容性。请参阅本指南之前介绍的当前 IR API。

结构

数据位置

typedef struct
{
	char filename[MAX_PATH];		当前日志文件
  	off_t offset;				偏移
  	unsigned char md5_1[16];		当前日志文件的 md5 签名
  	unsigned char md5_2[16];		下一个日志文件的 md5 签名
} IRDataPosition;

UT8 解释的审核记录

typedef struct tagSeosUTF8LogInterpreted
{
	char *Label;		记录中审核字段的标签
	char *Value;		审核记录中分配给字段的值
} SEOS_UTF8AUDLOGINTERP;

可能的返回值

原因代码	整数值	含义
IR_EAC_SUCCESS	0	成功
IR_EAC_NO_MORE_DATA	1	没有更多数据
IR_EAC_DATA_LOST	2	数据丢失
IR_EAC_GENERAL_FAIL	3	常规失败
IR_EAC_PSBLY_DATA_LOST	4	数据可能丢失

函数

int eacIR_LogInit(IRDataPosition *pos);

获取审核文件名（从 CA ControlMinder 设置）。

重置偏移，以获取最旧的日志文件，并打开文件以读取审核记录。

初始化 IRDataPosition 指针以调用 eacIR_LogGetNext()。

如果函数成功，则返回 IR_EAC_SUCCESS。

如果函数失败，则返回 IR_EAC_GENERAL_FAIL。

IRDataPosition: (OUT) 指向 IRDataPosition 结构的指针。

int eacIR_LogReset(IRDataPosition *pos);

根据给定（参数）数据位置打开日志文件（如果它仍然存在）。

此函数使您能够回到旧（已保存）状态，并从此状态继续操作。

如果函数成功，则返回 IR_EAC_SUCCESS。

如果函数失败，则返回 IR_EAC_GENERAL_FAIL。

IRDataPosition: (IN) 指向 IRDataPosition 结构的指针。

int eacIR_LogGetNext(IRDataPosition *pos, SEOS_UTF8AUDLOGINTERP **ppUtfMsg, int *log_type);

根据给定数据位置返回下一个日志记录及其类型。

可能的返回值如下：

条件	值
成功	IR_EAC_SUCCESS
没有更多数据	IR_EAC_NO_MORE_DATA
数据丢失	IR_EAC_DATA_LOST
常规失败	IR_EAC_GENERAL_FAIL
数据可能丢失	IR_EAC_PSBLY_DATA_LOST

IRDataPosition: (IN) 指向 IRDataPosition 的指针－表示获取下一个日志记录的位置。
UTF8 字符串: (OUT) 指向（UTF8 字符串）解释的记录的指针。
int: (OUT) 指向 int 的指针－表示下一个日志记录类型。

int eacIR_LogTerminate(void);

关闭日志文件，不供读取。在处理完 API 后调用此函数。

如果函数成功，则返回 IR_EAC_SUCCESS。

如果函数失败，则返回 IR_EAC_GENERAL_FAIL。

void eacIR_LogFreeInterpretRecord(void);

此函数释放最后解释的记录。

此函数不返回值。

注意：eacIR_LogGetNext() API 每次运行时都调用相同的内部函数，因此您不需要在调用下一个日志记录之前使用此 API。

char *eacIR_LogGetVersion(void);

将 API 版本以字符串返回。

返回值是字符串形式的版本号。