ccilsTraceActive

报告跟踪是否处于活动状态及其所在的活动级别。

语法

CCI_TRACE_TYPE cciIsTraceActive(
    int*                returnCode,
  CciObject*     object);

参数

returnCode
接收来自函数(输出)的返回码。NULL 指针输入表示用户定义的节点不要处理错误。在执行此调用期间别的任何异常都重新抛出到流中的下一个上 行节点。如果输入不是 NULL,则输出表示调用的成功状态。如果执行期间发生异常,则 *returnCode 设置为输出上的 CCI_EXCEPTION。对 CciGetLastExceptionData 的调用将提供异常的详细信息。
object
要与跟踪条目关联的对象的地址(输入)。该对象可以是 CciNode* 或 a CciParser*。如果是 CciNode*,则该节点的名称会写到跟踪。如果是 CciParser*,则创建解析器的节点的名称会写到跟踪。该对象也用于确定该条目是否应该写到跟踪。仅当跟踪对该节点活动时才会写该条目。节点当前从消息流中继承它们的跟踪设置。
如果该参数为 NULL,则会返回执行组的跟踪级别。

返回值

CCI_TRACE_TYPE 值表明当前处于活动状态的跟踪的级别。CCI_TRACE_TYPE 类型可具有以下这些值:
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
  • CCI_ SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE
这些返回值是按位值。这些值还可以组合起来,例如:
  • CCI_USER_NORMAL_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_NORMAL_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_SERVICE_DEBUG_TRACE
CCI_TRACE_NONE 是零值,而其他所有值都是非零值。
还有两个值可在查询跟踪的活动级别时用作位掩码。 这两个值是:
  • CCI_USER_TRACE
  • CCI_SERVICE_TRACE
例如,表达式(traceLevel & CCI_USER_TRACE) 将会为下列返回值将非零值赋予 traceLevel
  • CCI_USER_NORMAL_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_NORMAL_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_ SERVICE_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE + CCI_SERVICE_DEBUG_TRACE
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
表达式(traceLevel & CCI_USER_TRACE) 将会为下列返回值将零值赋予 traceLevel
  • CCI_SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE

示例

CciNode* thisNode = ((NODE_CONTEXT_ST*)context)->nodeObject;

const CCI_TRACE_TYPE   traceActive = cciIsTraceActive(&rc, (CciObject*)thisNode);
   checkRC(rc);
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as24540_