cciGetLastExceptionDataW

Obtener información de diagnóstico acerca de la última excepción generada. Se devuelve información sobre la última excepción generada en la hebra actual en una estructura de salida CCI_EXCEPTION_WIDE_ST. La extensión definida por el usuario puede utilizar esta función para determinar si se necesita una recuperación cuando una función de utilidad devuelve un código de error.

Esta función se puede invocar cuando una función de utilidad ha indicado que se ha producido una excepción estableciendo returnCode en CCI_EXCEPTION.

Sintaxis

void* cciGetLastExceptionDataW(
int*                        returnCode,
CCI_EXCEPTION_WIDE_ST*  exception_st);

Parámetros

returnCode
Recibe el código de retorno de la función (salida). Los códigos de retorno posibles son:
  • CCI_FATAL_EXCEPTION
  • CCI_RECOVERABLE_EXCEPTION
  • CCI_CONFIGURATION_EXCEPTION
  • CCI_PARSER_EXCEPTION
  • CCI_CONVERSION_EXCEPTION
  • CCI_DATABASE_EXCEPTION
  • CCI_USER_EXCEPTION
  • CCI_UNKNOWN_EXCEPTION
  • CCI_NO_EXCEPTION_EXISTS
  • CCI_INV_DATA_POINTER
exception_st
Especifica la dirección de una estructura CCI_EXCEPTION_WIDE_ST para recibir los datos acerca de la última excepción (salida).

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

typedef struct exception_wide_st {
int               versionId;     /* Identificación de versión de estructura */
int               type;          /* Tipo de excepción */
int               messageNumber; /* Número de mensaje */
int               insertCount;   /* Número de inserciones de mensaje */
CCI_STRING_ST     inserts[CCI_MAX_EXCEPTION_INSERTS];
/* Matriz de áreas de inserciones de mensaje */
const char*       fileName;      /* Origen: nombre de archivo */
int               lineNumber;    /* Origen: número de línea en archivo */
const char*       functionName;  /* Origen: nombre de función */
CCI_STRING_ST     traceText;	    /* Texto de rastreo asociado a la excepción */
CCI_STRING_ST     objectName;    /* Nombre de objeto */
CCI_STRING_ST     objectType;    /* Tipo de objeto */
} CCI_EXCEPTION_WIDE_ST;
CCI_EXCEPTION_WIDE_ST exception_st = malloc(sizeof(CCI_EXCEPTION_WIDE_ST));
int rc = 0;
memset(&exception_st,0,sizeof(exception_st));
cciGetLastExceptionDataW(&rc, &exception_st);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
as24620_