Códigos de retorno y valores de funciones de programa de utilidad

Por convenio, el parámetro de salida de código de retorno de todas las funciones de programa de utilidad se establece para indicar si la operación se ha realizado satisfactoriamente o si no ha sido así. La tabla siguiente lista todos los códigos de retorno con sus significados. Estos códigos de retorno se definen en el archivo de cabecera BipCci.h.

Tabla 1. Códigos de retorno y valores de funciones de programa de utilidad
Código de retorno Explicación
CCI_BUFFER_TOO_SMALL El almacenamiento intermedio de salida no es suficientemente grande para almacenar los datos solicitados.
CCI_EXCEPTION Se ha producido una excepción.
CCI_EXCEPTION_CONFIGURATION Se ha detectado una excepción de configuración al invocar la función. 1
CCI_EXCEPTION_CONVERSION Se ha detectado una excepción de conversión al invocar la función. 1
CCI_EXCEPTION_DATABASE Se ha detectado una excepción de base de datos al invocar la función.
CCI_EXCEPTION_FATAL Se ha detectado una excepción muy grave al invocar la función. 1
CCI_EXCEPTION_PARSER Se ha detectado una excepción de analizador al invocar la función. 1
CCI_EXCEPTION_RECOVERABLE Se ha detectado una excepción recuperable al invocar la función. 1
CCI_EXCEPTION_UNKNOWN Se ha especificado o encontrado una excepción desconocida.
CCI_EXCEPTION_USER Se ha detectado una excepción de usuario al invocar la función. 1
CCI_FAILURE Una función no se ha ejecutado satisfactoriamente.
CCI_FAILURE_CONTINUE Valor de retorno de cniRun(): restituir el proceso de mensajes y continuar la ejecución de hebra
CCI_FAILURE_RETURN Valor de retorno de cniRun(): restituir el proceso de mensajes y devolver la hebra a la agrupación
CCI_INV_CODEPAGE Se ha especificado un número de página de códigos que no es válido.
CCI_INV_CHARACTER Se ha detectado en el almacenamiento intermedio un carácter que no es válido para convertirlo.
CCI_INV_DATA_BUFLEN Se ha especificado una longitud de almacenamiento intermedio de datos de cero.
CCI_INV_DATA_POINTER Se ha especificado un puntero nulo para la dirección de un área de datos de salida.
CCI_INV_ELEMENT_OBJECT Se ha especificado un puntero nulo para el objeto de elemento.
CCI_INV_FACTORY_NAME Se ha especificado un nombre de fábrica que no es válido (espacio en blanco).
CCI_INV_FACTORY_OBJECT Se ha especificado un puntero nulo para el objeto de fábrica.
CCI_INV_IMPL_FUNCTION Se ha especificado una combinación no válida de funciones de implementación condicionales
CCI_INV_LENGTH Se ha especificado una longitud de cero.
CCI_INV_LOG_TYPE El tipo de anotaciones especificado no es válido.
CCI_INV_MESSAGE_CONTEXT Se ha especificado un puntero nulo para el contexto de mensaje.
CCI_INV_MESSAGE_OBJECT Se ha especificado un puntero nulo para el objeto de mensaje.
CCI_INV_NODE_ENV Intente despachar una hebra de un nodo que no es de entrada.
CCI_INV_NODE_NAME Se ha especificado un nombre de nodo que no es válido (espacio en blanco).
CCI_INV_NODE_OBJECT Se ha especificado un puntero nulo para el objeto de nodo.
CCI_INV_OBJECT_NAME Los caracteres especificados en el nombre de objeto no eran válidos.
CCI_INV_PARSER_NAME Se ha especificado un nombre de clase de analizador que no es válido (espacio en blanco).
CCI_INV_PARSER_OBJECT Se ha especificado un puntero nulo para el objeto de analizador.
CCI_INV_SQL_EXPR_OBJECT Se ha especificado un puntero nulo para un valor de expresión SQL.
CCI_INV_STATEMENT No se ha especificado una sentencia.
CCI_INV_TERMINAL_NAME Se ha especificado un nombre de terminal que no es válido (espacio en blanco).
CCI_INV_TERMINAL_OBJECT Se ha especificado un puntero nulo para el objeto de terminal.
CCI_INV_TRANSACTION_TYPE Se ha especificado un valor no válido para el tipo de transacción.
CCI_INV_VFTP Se ha especificado un puntero nulo para la dirección de la tabla de punteros de función virtual de extensión definida por el usuario.
CCI_MISSING_IMPL_FUNCTION No se ha definido una función de implementación obligatoria en la tabla de punteros de función.
CCI_NAME_EXISTS Ya existe un analizador con el mismo nombre de clase.
CCI_NO_BUFFER_EXISTS No existe ningún almacenamiento intermedio para el objeto de analizador especificado.
CCI_NO_EXCEPTION_EXISTS No se ha encontrado ninguna excepción anterior para esta hebra.
CCI_NO_THREADS_AVAILABLE No había hebras disponibles para despacharlas.
CCI_NULL_ADDR Una función que debe devolver una dirección no se ha ejecutado satisfactoriamente: en su lugar, se devuelve cero.
CCI_PARSER_NAME_TOO_LONG El nombre de la clase de analizador es demasiado largo.
CCI_SUCCESS Realización satisfactoria.
CCI_SUCCESS_CONTINUE Valor de retorno de cniRun(): confirmar el proceso de mensajes y continuar la ejecución de hebra
CCI_SUCCESS_RETURN Valor de retorno de cniRun(): confirmar el proceso de mensajes y devolver la hebra a la agrupación
CCI_TIMEOUT Valor de retorno de cniRun(): no hay ningún proceso de mensajes pero continuar la ejecución de hebra
Nota:
  1. Este código de retorno sólo lo devuelve cniGetLastExceptionData para indicar el tipo de la última excepción.
Referencia relacionada
Funciones de programa de utilidad comunes en C
Archivos de cabecera
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08557_