GET_ERROR_INFO

Válido para

Extraer y Replicat

Descripción

Utilice la función GET_ERROR_INFO para recuperar la información de error asociada a un registro de desecho. La salida de usuario puede utilizar esta información en la lógica de manejo de errores personalizada. Por ejemplo, la salida de usuario podría enviar un mensaje de correo electrónico con información detallada del error.

Si la sesión de caracteres de la salida de usuario se define con SET_SESSION_CHARSET en un valor distinto del juego de caracteres por defecto del sistema operativo, como se define en ULIB_CS_DEFAULT en el archivo ucharset.h, los datos del mensaje que se intercambia entre la salida de usuario y el proceso se interpretan en el juego de caracteres de la sesión.

Sintaxis

#include "usrdecs.h"
short result_code;
error_info_def error_info;
ERCALLBACK (GET_ERROR_INFO, &error_info, &result_code);

Buffer

typedef struct
{
long error_num;
char *error_msg;
long max_length;
long actual_length;
short msg_truncated;
} error_info_def;

Entrada

<error_msg>

Un puntero a un buffer para aceptar el mensaje de error devuelto.

<max_length>

Longitud máxima del buffer error_msg asignado para aceptar cualquier mensaje de error resultante. Se devuelve como una cadena terminada NULL.

Salida

<error_num>

Número de error del sistema o SQL asociado al registro descartado.

<error_msg>

Puntero a la cadena de mensaje de error de terminación nula asociada al registro descartado.

<actual_length>

Longitud del mensaje de error, sin incluir el terminador nulo.

<msg_truncated>

Indicador (0 o 1) que indica si el mensaje de error se ha truncado o no. El truncamiento se produce si la longitud del mensaje de error más un terminador nulo supera la longitud máxima del buffer.

Valores devueltos

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_OK