cciLog

Registra um evento de erro, de aviso ou informativo. O evento é registrado pela interface do intermediário de mensagens utilizando os argumentos especificados como dados de log.

Sintaxe

void cciLog(
  int*          returnCode,
  CCI_LOG_TYPE  type,
  char*         file,
  int           line,
  char*         function,
  CciChar*      messageSource,
  int           messageNumber,
  char*         traceText,
                ...);

Parâmetros

returnCode
O código de retorno da função (saída).
type
O tipo de evento, conforme definido por CCI_LOG_TYPE (entrada). Os valores válidos são:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
O nome do arquivo de origem onde a função foi chamada (entrada). O valor é opcional, mas é útil para fins de depuração.
line
O número da linha no arquivo de origem onde a função foi chamada (entrada). O valor é opcional, mas é útil para fins de depuração.
function
O nome da função que chamou a função de log (entrada). O valor é opcional, mas é útil para fins de depuração.
messageSource
Uma cadeia que identifica a origem da mensagem do Windows ou o catálogo de mensagens do UNIX.
messageNumber
O número da mensagem identificando o evento (entrada). Se messageNumber for especificado como zero, supõe-se que a mensagem não está disponível. Se messageNumber for diferente de zero, a mensagem especificada é gravada no log de eventos do intermediário com quaisquer inserções fornecidas na lista de argumentos variáveis (consulte adiante).
traceText
Informações de rastreio que são gravadas no log de rastreio de serviço do intermediário (entrada). As informações são opcionais, mas são úteis para fins de depuração.
...
Uma lista de argumentos variáveis em C contendo quaisquer inserções de mensagem que acompanham a mensagem (entrada). Essas inserções são tratadas como cadeias de caracteres, e os argumentos variáveis são considerados como sendo do tipo pointer to char.
Nota: Os caracteres char* devem ser cadeias em ASCII (Latino) ou EBCDIC (1047).
Nota: O último argumento nesta lista precisa ser (char*)0.

Valores de Retorno

Nenhuma. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.

Conceitos relacionados
Extensões Definidas pelo Usuário

Tarefas relacionadas
Criando um Nó de Entrada em C
Criando um Nó de Processamento de Mensagem em C
Criando um Analisador em C

Referências relacionadas
Extensões Definidas pelo Usuário
cciGetLastExceptionData
cciRethrowLastException
cciThrowException