GET_COLUMN_NAME_FROM_INDEX

Válido para

Extraer y Replicat

Descripción

Utilice la función GET_COLUMN_NAME_FROM_INDEX para determinar el nombre de columna asociado a un índice de columna especificado. Si la sesión de caracteres de la salida de usuario se define con SET_SESSION_CHARSET en un valor distinto del juego de caracteres por defecto del sistema operativo, como se define en ULIB_CS_DEFAULT en el archivo ucharset.h, los datos de caracteres que se intercambian entre la salida de usuario y el proceso se interpretan en el juego de caracteres de la sesión.

Los nombres de objetos de base de datos se devuelven exactamente como se definen en la base de datos de alojamiento, incluidas las mayúsculas y minúsculas.

Sintaxis

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

Entrada

<buffer>

Un puntero a un buffer para aceptar el nombre de columna devuelto. El nombre de columna es nulo.

<max_length>

Longitud máxima de la buffer asignada para aceptar el nombre de columna resultante. Se devuelve como una cadena terminada NULL.

<index>

Índice de columna del nombre de columna que se va a devolver.

<source_or_target>

Una de las siguientes opciones para indicar si se debe utilizar la tabla de origen o de destino para buscar información de columna.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

Salida

<buffer>

Nombre de columna con terminación nula.

longitud real

Longitud de cadena del nombre de columna devuelto. La longitud real no incluye el terminador nulo.

<value_truncated>

Indicador (0 o 1) para indicar si el valor se ha truncado o no. El truncamiento se produce si la longitud del nombre de columna más el terminador nulo supera la longitud máxima del buffer.

Valores devueltos

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK