ccilsTraceActive

Relata se o rastreio está ativo e o nível no qual ele está ativo.

Sintaxe

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

Parâmetros

returnCode
Recebe o código de retorno da função (saída).Um entrada de ponteiro NULL significa que o nó definido pelo usuário não irá lidar com erros. Quaisquer exceções lançadas durante a execução desta chamada serão lançadas novamente para o próximo nó acima no fluxo. Se a entrada não for NULL, a saída significará o status de êxito da chamada. Se uma exceção ocorrer durante a execução, *returnCode será definido como CCI_EXCEPTION na saída. Uma chamada para CciGetLastExceptionData fornecerá detalhes da exceção.
object
O endereço do objeto que deve ser associado à entrada de rastreio (entrada). Esse objeto pode ser um CciNode* ou um CciParser*. Se for um CciNode*, o nome desse nó será gravado no rastreio. Se for um CciParser*, o nome do nó que criou o analisador será gravado no rastreio. Esse objeto também é utilizado para determinar se a entrada deve ser escrita no rastreio. A entrada apenas será escrita, se o rastreio estiver ativo para o nó. Atualmente, os nós herdam a configuração do rastreio a partir do fluxo de mensagens.
Se este parâmetro for NULL, o nível de rastreio para o grupo de execução será retornado.

Valores de Retorno

Um valor CCI_TRACE_TYPE indicando o nível de rastreio atualmente ativo. O tipo CCI_TRACE_TYPE possui os seguintes valores possíveis:
  • CCI_USER_NORMAL_TRACE
  • CCI_USER_DEBUG_TRACE
  • CCI_ SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE
Esses valores de retorno são valores de bit a bit. As combinações desses valores também são possíveis, por exemplo:
  • 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 é um valor zero e todos os outros valores são diferentes de zero.
Dois valores adicionais podem ser utilizados como de bit a bit, durante a consulta do nível de rastreio ativo. São eles:
  • CCI_USER_TRACE
  • CCI_SERVICE_TRACE
Por exemplo, a expressão (traceLevel & CCI_USER_TRACE) será avaliada como um valor diferente de zero para traceLevel, para obter os seguintes valores de retorno:
  • 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
A expressão (traceLevel & CCI_USER_TRACE) será avaliada como um valor zero para traceLevel, para obter os seguintes valores de retorno:
  • CCI_SERVICE_NORMAL_TRACE
  • CCI_SERVICE_DEBUG_TRACE
  • CCI_TRACE_NONE

Exemplo

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

const CCI_TRACE_TYPE   traceActive = cciIsTraceActive(&rc, (CciObject*)thisNode);
    checkRC(rc);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as24540_