prg_log_write()
摘要
将一条记录直接写入日志存储。
语法
prg_log_write (log_store_hndl, options, …)
| 参数 | 类型 | 说明 |
|---|---|---|
log_store_hndl |
PrgT_Log_Store_Handle |
所关注的日志存储。 |
options |
int |
写入日志记录的选项(参见 options)。 |
… |
various |
日志记录的附加列(参见 …)。 |
返回类型
PrgT_Compcode
记录成功添加时返回 PrgC_Compcode_Success,否则返回 PrgC_Compcode_Failure。
头文件
prg_log.h
详情
本函数允许将记录直接写入日志存储,而无需获取日志句柄(prg_log_handle_write() 则要求如此)。
在根据 … 参数指定的数据组装出日志记录后,本函数将该记录写入日志存储。
options
options 参数必须是 PRGC_LOG_WRITE_OPT_NONE 或:
PRGC_LOG_WRITE_OPT_COLUMN_NAME——… 值中包含列名
…
可变参数 (…) 指定附加的列数据。通常,该参数由针对日志模板中定义的每个列的 [type, value] 成对值组成。这些成对值必须按照列在模板中定义的顺序出现。
如果设置了 PRGC_LOG_WRITE_OPT_COLUMN_NAME 选项,则 … 参数由一个或多个 [column title, value type, value] 三元组组成,其后跟一个空值(PRGC_NIL)以终止参数串。在这种情况下,只需指定所需的列。