prg_log_handle_generate()

摘要

按指定的列条件,查找或创建针对特定日志存储的日志句柄。

语法

prg_log_handle_generate (log_store_hndl, incident_limit, …)
参数 类型 说明
log_store_hndl PrgT_Log_Store_Handle 要为其生成日志句柄的日志存储。
incident_limit unsigned long 该句柄可记录的条目数上限。
… various 一个或多个指定目标日志列的元组(见详情)。

返回类型

PrgT_Log *

所请求的日志句柄。

头文件

prg_log.h

详情

该函数为特定日志存储生成日志句柄。该日志句柄与 prg_log_handle_write() 配合使用,向该日志存储添加日志条目。以这种方式添加到日志存储的每个条目都会自动填充某些列的值。这些列及其对应的值由该函数的可变参数(…)指定:该参数由 n 个元组(n >= 1)组成,其后跟一个空值(PRGC_NIL)以终止参数串。每个元组由一个列标题、一个值类型和一个值组成。

incident_limit 参数指定可以使用该函数返回的句柄添加的条目数量。达到该上限后,后续条目将被忽略,不会记录到日志存储中。

如果针对同一日志存储和同一组元组的日志句柄已经存在,该函数将返回该日志句柄。必要时,现有日志句柄的条目数上限会被设置为 incident_limit,并且该日志句柄的引用计数加一。如果不存在匹配的日志句柄,该函数将创建一个新的。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com