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,并且该日志句柄的引用计数加一。如果不存在匹配的日志句柄,该函数将创建一个新的。