cciLog

Esta función anota un error, un aviso o un suceso informativo. La interfaz de intermediario de mensajes anota el suceso utilizando los argumentos especificados como datos de anotaciones.

Sintaxis

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

Parámetros

returnCode
Código de retorno de la función (salida).
type
Tipo de suceso, como se define mediante CCI_LOG_TYPE (entrada). Los valores válidos son:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
Nombre de archivo de origen en el que se ha invocado la función (entrada). El valor es opcional, pero es útil para realizar la depuración.
line
Número de línea del archivo de origen en el que se ha invocado la función (entrada). El valor es opcional, pero es útil para realizar la depuración.
function
Nombre de función que ha invocado la función de anotaciones (entrada). El valor es opcional, pero es útil para realizar la depuración.
messageSource
Serie de caracteres que identifica el origen de mensajes de Windows o el catálogo de mensajes de UNIX.
messageNumber
Número de mensaje que identifica el suceso (entrada). Si messageNumber se especifica como cero, se presupone que un mensaje no está disponible. Si messageNumber se especifica con un valor distinto a cero, el mensaje especificado es escribe en las anotaciones de sucesos del intermediario con las inserciones suministradas en la lista de argumentos de variable (consulte información que figura a continuación).
traceText
Información de rastreo que se escribe en las anotaciones de rastreo de servicio del intermediario (entrada). La información es opcional, pero es útil para realizar la depuración.
...
Lista de argumentos de variable C que contiene inserciones de mensajes que acompañan al mensaje (entrada). Estas inserciones son tratadas como series de caracteres, y se presupone que los argumentos de variable son del tipo pointer to char.
Nota: los caracteres char* deben ser series de caracteres en ASCII (latín) o EBCDIC (1047).
Nota: El último argumento de esta lista debe ser (char*)0.

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la causa de dicho error.

Conceptos relacionados
Extensiones definidas por el usuario

Tareas relacionadas
Creación de un nodo de entrada en C
Creación de un nodo de proceso de mensajes en C
Creación de un analizador en C

Referencia relacionada
Extensiones definidas por el usuario
cciGetLastExceptionData
cciRethrowLastException
cciThrowException