GET_SCHEMA_NAME_ONLY

Válido para

Extraer y Replicat

Descripción

Utilice la función GET_SCHEMA_NAME_ONLY para recuperar el nombre del propietario (como el esquema), pero no el nombre del catálogo, el contenedor (si procede) o el objeto, del objeto de origen o de destino asociado al registro que se está procesando. Esta función es válida para las operaciones DML y DDL.

Para devolver el nombre completo de una tabla, consulte lo siguiente:

GET_TABLE_NAME

Para devolver el nombre totalmente cualificado de un objeto no de tabla, como un usuario, una vista o <index>, consulte lo siguiente:

GET_OBJECT_NAME

Para devolver solo el nombre de objeto o tabla no cualificado, consulte lo siguiente:

GET_TABLE_NAME_ONLY

GET_OBJECT_NAME_ONLY

Para devolver otras partes del nombre de la tabla u objeto, consulte lo siguiente:

GET_CATALOG_NAME_ONLY

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_SCHEMA_NAME_ONLY, &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>

Puntero a un buffer para aceptar el nombre de esquema devuelto. El nombre es nulo.

<max_length>

Longitud máxima del buffer asignado para aceptar el nombre del esquema. Se devuelve como una cadena terminada NULL.

<source_or_target>

Una de las siguientes indicaciones indica si se debe devolver el nombre del esquema de origen o de destino.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

Salida

<buffer>

Nombre de esquema totalmente cualificado y con terminación nula.

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, el nombre del esquema se interpreta en el juego de caracteres de la sesión.

<actual_length>

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

<value_truncated>

Indicador (0 o 1) que indica si el valor se ha truncado o no. El truncamiento se produce si la longitud del nombre del esquema 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