GET_COLUMN_NAME_FROM_INDEX

Valido per

Estrai e Replicat

Descrizione

Utilizzare la funzione GET_COLUMN_NAME_FROM_INDEX per determinare il nome di colonna associato a un indice di colonna specificato. Se la sessione dei caratteri dell'uscita utente è 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 dei caratteri scambiati tra l'uscita utente e il processo vengono interpretati nel set di caratteri della sessione.

I nomi degli oggetti di database vengono restituiti esattamente come sono definiti nel database di hosting, inclusa la lettera maiuscola.

Sintassi

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

Buffer

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

Input

<buffer>

Un puntatore a un buffer per accettare il nome di colonna restituito. Il nome della colonna è nullo.

<max_length>

La lunghezza massima del valore buffer allocato per accettare il nome colonna risultante. Viene restituito come stringa terminata NULL.

<index>

Indice di colonna del nome di colonna da restituire.

<source_or_target>

Una delle seguenti opzioni indica se utilizzare la tabella di origine o di destinazione per cercare le informazioni sulle colonne.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

Output

<buffer>

Il nome della colonna con terminazione nulla.

lunghezza effettiva

La lunghezza della stringa del nome colonna restituito. La lunghezza effettiva non include il terminatore nullo.

<value_truncated>

Flag (0 o 1) per indicare se il valore è stato troncato o meno. La troncatura si verifica se la lunghezza del nome della colonna più il terminatore nullo supera la lunghezza massima del buffer.

Valori restituiti

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK