GET_COLUMN_NAME_FROM_INDEX

Durée de validité

Extraction et réplication

Description

Utilisez la fonction GET_COLUMN_NAME_FROM_INDEX pour déterminer le nom de colonne associé à un index de colonne spécifié. 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 caractères échangées entre l'exit utilisateur et le processus sont interprétées dans le jeu de caractères de session.

Les noms d'objet de base de données sont renvoyés exactement tels qu'ils sont définis dans la base de données d'hébergement, y compris la casse des lettres.

Syntaxe

#include "usrdecs.h"
short result_code;
env_value_def env_value;
ERCALLBACK (GET_COLUMN_NAME_FROM_INDEX, &env_value, &result_code);

Tampon

typedef struct
{
char *buffer;
long max_length;
long actual_length;
short value_truncated;
short index;
short source_or_target;
} env_value_def;

Entrée

<buffer>

Pointeur vers un tampon pour accepter le nom de colonne renvoyé. Le nom de la colonne prend fin avec la valeur NULL.

<max_length>

Longueur maximale de l'élément buffer alloué pour accepter le nom de colonne obtenu. Cette valeur est renvoyée sous la forme d'une chaîne de fin NULL.

<index>

Index de colonne du nom de colonne à renvoyer.

<source_or_target>

L'une des méthodes suivantes permet d'indiquer si la table source ou cible doit être utilisée pour rechercher des informations sur les colonnes.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

Sortie

<buffer>

Nom de colonne dont la fin est NULL.

longueur réelle

Longueur de chaîne du nom de colonne renvoyé. La longueur réelle n'inclut pas le terminateur NULL.

<value_truncated>

Indicateur (0 ou 1) indiquant si la valeur a été tronquée. La troncature se produit si la longueur du nom de colonne plus la terminaison NULL dépasse la longueur maximale du tampon.

Valeurs retournées

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK