写到 C 编程语言 API 的消息处理节点和解析器可将项写到跟踪中。
用户定义的扩展可以不受跟踪设置的影响来使用 cci*Trace 函数。 这些函数函数判定跟踪是否处于活动状态,且只编写符合跟踪设置的项。调用 cci*Trace 函数时,可以要求进行一些额外处理。cciIsTraceActive 函数可用来让用户定义的扩展查询跟踪设置并避免在跟踪处于非活动状态的情况下进行这种额外的处理。
在很多情况下,将 cciIsTraceActive 函数返回的值作为布尔值使用即可。如果返回的是非零值,则表明跟踪在某个级别上处于活动状态,这时可以调用 cci*Trace 函数中的任意一个。 在需要了解跟踪设置的详细情况时,也可对返回值进行细致监查。
跟踪设置可随时进行更改,因此建议对它们经常进行查询。例如,当进入实施函数时,可用 cciIsTraceActive 来查询跟踪设置。
跟踪条目可与某些对象关联,这样就可以对跟踪的编写进行更好的控制。跟踪条目可与节点或解析器关联,然后跟踪将根据那对象的跟踪设置被编写。该对象的跟踪设置将从节点或解析器属于的消息流中继承。如果不指定对象,则跟踪将与执行组关联。