cciLog

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). Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_INV_DATA_POINTER
  • CCI_INV_LOG_TYPE
type
Tipo de suceso, como lo define CCI_LOG_TYPE (entrada). Los valores válidos son:
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
Nombre de archivo de origen donde se ha invocado la función (entrada). El valor es opcional, pero es útil para realizar depuraciones.
line
Número de línea del archivo de origen donde se ha invocado la función (entrada). El valor es opcional, pero es útil para realizar depuraciones.
function
Nombre de función que ha invocado la función de anotación (entrada). El valor es opcional, pero es útil para realizar depuraciones.
messageSource
Serie de caracteres que identifica el origen de mensajes Windows o el catálogo de mensajes de Linux y UNIX.
messageNumber
Número de mensaje que identifica el suceso (entrada). Si messageNumber se especifica como cero, se supone que un mensaje no está disponible. Si messageNumber es distinto de cero, el mensaje especificado se graba en el registro de sucesos de intermediario con las inserciones proporcionadas en la lista de argumentos variables (consulte más abajo).
traceText
Información de rastreo que se graba en las anotaciones de rastreo de servicio de intermediario (entrada). La información es opcional, pero es útil para realizar depuraciones.
...
Lista de argumentos variables C que contiene las inserciones de mensaje que acompañan al mensaje (entrada). Estas inserciones se tratan como series de caracteres y se supone que los argumentos variables son de tipo puntero a carácter.
Nota: Los caracteres char* deben ser series de caracteres en ASCII (Latin) 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 razón del mismo.

Conceptos relacionados
Extensiones definidas por el usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08552_