GET_COLUMN_INDEX_FROM_NAME

Válido Para

Extract e Replicat

Descrição

Use a função GET_COLUMN_INDEX_FROM_NAME para determinar o índice de coluna associado a um nome de coluna especificado. Se a sessão de caracteres da saída do usuário for definida com SET_SESSION_CHARSET para um valor diferente do conjunto de caracteres padrão do sistema operacional, conforme definido em ULIB_CS_DEFAULT no arquivo ucharset.h, os dados de caracteres que são trocados entre a saída do usuário e o processo serão interpretados no conjunto de caracteres da sessão.

Se o banco de dados fizer distinção entre maiúsculas e minúsculas, os nomes de objetos devem ser especificados na mesma letra que são definidos no banco de dados de hospedagem; caso contrário, a letra não importa.

Sintaxe

#include "usrdecs.h"
short result_code;
env_value_def env_value;
ERCALLBACK (GET_COLUMN_INDEX_FROM_NAME, &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>

Um ponteiro para o nome da coluna

<actual_length>

O tamanho do nome da coluna dentro do buffer.

<source_or_target>

Uma das opções a seguir indica se a tabela de origem ou de destino deve ser usada para pesquisar informações da coluna.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

Saída

<index>

O índice de coluna retornado para o nome de coluna especificado.

Valores de Retorno

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK