GET_ERROR_INFO

Valido per

Estrai e Replicat

Descrizione

Utilizzare la funzione GET_ERROR_INFO per recuperare le informazioni sugli errori associate a un record di scarto. L'uscita utente può utilizzare queste informazioni nella logica di gestione degli errori personalizzata. Ad esempio, l'uscita utente potrebbe inviare un messaggio di posta elettronica con informazioni dettagliate sull'errore.

Se la sessione di caratteri dell'uscita utente viene impostata con SET_SESSION_CHARSET su un valore diverso dal set di caratteri predefinito del sistema operativo, come definito in ULIB_CS_DEFAULT nel file ucharset.h, i dati del messaggio scambiati tra l'uscita utente e il processo vengono interpretati nel set di caratteri della sessione.

Sintassi

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

Input

<error_msg>

Un puntatore a un buffer per accettare il messaggio di errore restituito.

<max_length>

La lunghezza massima del buffer error_msg allocato per accettare qualsiasi messaggio di errore risultante. Viene restituito come stringa terminata NULL.

Output

<error_num>

Numero di errore SQL o di sistema associato al record eliminato.

<error_msg>

Puntatore alla stringa del messaggio di errore con terminazione nulla associata al record eliminato.

<actual_length>

Lunghezza del messaggio di errore, escluso il terminatore nullo.

<msg_truncated>

Flag (0 o 1) che indica se il messaggio di errore è stato troncato o meno. La troncatura si verifica se la lunghezza del messaggio di errore più un terminatore nullo supera la lunghezza massima del buffer.

Valori restituiti

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_OK