GET_ERROR_INFO

Válido Para

Extract e Replicat

Descrição

Use a função GET_ERROR_INFO para recuperar informações de erro associadas a um registro de descarte. A saída do usuário pode usar essas informações na lógica personalizada de tratamento de erros. Por exemplo, a saída do usuário pode enviar uma mensagem de e-mail com informações detalhadas sobre o erro.

Se a sessão de caracteres da saída do usuário for definida com SET_SESSION_CHARSET para um valor diferente do conjunto de caracteres padrão do sistema operacional, conforme definido em ULIB_CS_DEFAULT no arquivo ucharset.h, os dados da mensagem que são trocados entre a saída do usuário e o processo serão interpretados no conjunto de caracteres da sessão.

Sintaxe

#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>

Um ponteiro para um buffer para aceitar a mensagem de erro retornada.

<max_length>

O tamanho máximo do buffer error_msg alocado para aceitar qualquer mensagem de erro resultante. Isso é retornado como uma string encerrada NULL.

Saída

<error_num>

O número de erro do SQL ou do sistema associado ao registro descartado.

<error_msg>

Um ponteiro para a string de mensagem de erro terminada com nulo associada ao registro descartado.

<actual_length>

O tamanho da mensagem de erro, não incluindo o terminador nulo.

<msg_truncated>

Um flag (0 ou 1) indicando se a mensagem de erro foi truncada ou não. Truncação ocorre se o tamanho da mensagem de erro mais um terminador nulo exceder o tamanho máximo do buffer.

Valores de Retorno

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_OK