GET_COLUMN_NAME_FROM_INDEX

Gültig für

Extrakt und Replicat

Beschreibung

Verwenden Sie die Funktion GET_COLUMN_NAME_FROM_INDEX, um den Spaltennamen zu bestimmen, der mit einem angegebenen Spaltenindex verknüpft ist. Wenn die Zeichensession des User Exit mit SET_SESSION_CHARSET auf einen anderen Wert als den Standardzeichensatz des Betriebssystems gesetzt wird, wie in ULIB_CS_DEFAULT in der Datei ucharset.h definiert, werden die Zeichendaten, die zwischen dem User Exit und dem Prozess ausgetauscht werden, im Sessionzeichensatz interpretiert.

Datenbankobjektnamen werden genau so zurückgegeben, wie sie in der Hostdatenbank definiert sind, einschließlich der Groß-/Kleinschreibung.

Syntax

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

Puffer

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

Eingabe

<buffer>

Ein Zeiger auf einen Puffer, um den zurückgegebenen Spaltennamen zu akzeptieren. Der Spaltenname ist Null-beendet.

<max_length>

Die maximale Länge der zugewiesenen buffer, um den resultierenden Spaltennamen zu akzeptieren. Dies wird als beendete NULL-Zeichenfolge zurückgegeben.

<index>

Der Spaltenindex des zurückzugebenden Spaltennamens.

<source_or_target>

Eine der folgenden Optionen gibt an, ob die Quell- oder Zieltabelle zum Suchen von Spalteninformationen verwendet werden soll.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

Ausgabe

<buffer>

Der mit Null beendete Spaltenname.

Istlänge

Die Zeichenfolgenlänge des zurückgegebenen Spaltennamens. Die tatsächliche Länge enthält nicht den Null-Terminator.

<value_truncated>

Ein Flag (0 oder 1), das angibt, ob der Wert abgeschnitten wurde. Eine Abkürzung tritt auf, wenn die Länge des Spaltennamens plus des Null-Terminators die maximale Pufferlänge überschreitet.

Rückgabewerte

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK