GET_ERROR_INFO

Durée de validité

Extraction et réplication

Description

Utilisez la fonction GET_ERROR_INFO pour extraire les informations d'erreur associées à un enregistrement de rejet. L'exit utilisateur peut utiliser ces informations dans la logique personnalisée de gestion des erreurs. Par exemple, l'exit utilisateur peut envoyer un message électronique contenant des informations détaillées sur l'erreur.

Si la session de caractères de l'exit utilisateur est définie avec SET_SESSION_CHARSET sur une valeur autre que le jeu de caractères par défaut du système d'exploitation, tel que défini dans ULIB_CS_DEFAULT dans le fichier ucharset.h, les données de message échangées entre l'exit utilisateur et le processus sont interprétées dans le jeu de caractères de session.

Syntaxe

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

Tampon

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

Entrée

<error_msg>

Pointeur vers un tampon pour accepter le message d'erreur renvoyé.

<max_length>

Longueur maximale du tampon error_msg alloué pour accepter tout message d'erreur résultant. Cette valeur est renvoyée sous la forme d'une chaîne de fin NULL.

Sortie

<error_num>

Numéro d'erreur SQL ou système associé à l'enregistrement supprimé.

<error_msg>

Pointeur vers la chaîne de message d'erreur ayant pris fin avec la valeur NULL associée à l'enregistrement supprimé.

<actual_length>

Longueur du message d'erreur, sans le terminateur NULL.

<msg_truncated>

Indicateur (0 ou 1) indiquant si le message d'erreur a été tronqué ou non. La troncature se produit si la longueur du message d'erreur plus une terminaison NULL dépasse la longueur maximale du tampon.

Valeurs retournées

EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_OK