cciThrowException

Esta función emite una excepción. La interfaz de intermediario de mensajes emite la excepción utilizando los argumentos especificados como datos de excepción.

Sintaxis

void cciThrowException(
  int*                returnCode,
  CCI_EXCEPTION_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 excepción (entrada). Los valores válidos son:
  • CCI_FATAL_EXCEPTION
  • CCI_RECOVERABLE_EXCEPTION
  • CCI_CONFIGURATION_EXCEPTION
  • CCI_PARSER_EXCEPTION
  • CCI_CONVERSION_EXCEPTION
  • CCI_DATABASE_EXCEPTION
  • CCI_USER_EXCEPTION
file
Nombre de archivo de origen en el que se ha generado la excepció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 generado la excepción (entrada). El valor es opcional, pero es útil para realizar la depuración.
function
Nombre de función que ha generado la excepción (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 la excepción (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.
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 solucionar problemas de 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
cciLog
cciRethrowLastException