cciThrowException

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

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). El código de retorno posible es CCI_INV_DATA_POINTER.
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 donde se ha generado la excepción (entrada). El valor es opcional, pero es útil al realizar depuraciones.
line
Número de línea del archivo de origen donde se ha generado la excepción (entrada). El valor es opcional, pero es útil al realizar depuraciones.
function
Nombre de función que ha generado la excepción (entrada). El valor es opcional, pero es útil al 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 la excepción (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.
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 al depurar problemas.
...
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
as08554_