GET_SCHEMA_NAME_ONLY

Valido per

Estrai e Replicat

Descrizione

Utilizzare la funzione GET_SCHEMA_NAME_ONLY per recuperare il nome del proprietario, ad esempio lo schema, ma non il nome del catalogo o del contenitore (se applicabile) o l'oggetto, dell'oggetto di origine o di destinazione associato al record in fase di elaborazione. Questa funzione è valida per le operazioni DML e DDL.

Per restituire il nome completo di una tabella, vedere:

GET_TABLE_NAME

Per restituire il nome completo di un oggetto non tabella, ad esempio un utente, una vista o <index>, vedere quanto segue:

GET_OBJECT_NAME

Per restituire solo il nome della tabella o dell'oggetto non qualificato, vedere:

GET_TABLE_NAME_ONLY

GET_OBJECT_NAME_ONLY

Per restituire altre parti della tabella o del nome dell'oggetto, vedere:

GET_CATALOG_NAME_ONLY

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

Input

<buffer>

Un puntatore a un buffer per accettare il nome dello schema restituito. Il nome è nullo.

<max_length>

La lunghezza massima del buffer allocato per accettare il nome dello schema. Viene restituito come stringa terminata NULL.

<source_or_target>

Una delle seguenti opzioni indica se restituire il nome dello schema di origine o di destinazione.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

Output

<buffer>

Nome dello schema completamente qualificato con terminazione nulla.

Se la sessione di caratteri dell'uscita utente viene 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, il nome dello schema viene interpretato nel set di caratteri della sessione.

<actual_length>

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

<value_truncated>

Flag (0 o 1) che indica se il valore è stato troncato o meno. La troncatura si verifica se la lunghezza del nome dello schema 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