GET_OBJECT_NAME_ONLY

유효 기간

추출 및 복제

설명

GET_OBJECT_NAME_ONLY 함수를 사용하여 처리 중인 레코드와 연관된 소스 또는 대상 객체의 부적격 이름(카탈로그, 컨테이너 또는 스키마 제외)을 검색합니다. 이 함수는 DML 또는 DDL 작업의 테이블 및 기타 객체에 대해 적합합니다.

객체의 전체 이름을 반환하려면 다음을 참조하십시오.

GET_OBJECT_NAME

객체 이름의 다른 부분을 반환하려면 다음을 참조하십시오.

GET_SCHEMA_NAME_ONLY GET_CATALOG_NAME_ONLY

데이터베이스 객체 이름은 대소문자를 포함하여 호스팅 데이터베이스에 정의된 대로 정확하게 반환됩니다.

구문

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

버퍼

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

입력

<buffer>

반환된 객체 이름을 수락할 버퍼에 대한 포인터입니다. 이름이 널로 종료되었습니다.

<max_length>

객체 이름을 수락할 할당된 버퍼의 최대 길이입니다. NULL 종료 문자열로 반환됩니다.

<source_or_target>

다음 중 하나는 소스 또는 대상 객체 이름을 반환할지 여부를 나타냅니다.

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

출력

<buffer>

정규화되고 널로 종료된 객체 이름(예: 데이터베이스 플랫폼에 따라 schema.object 또는 catalog.schema.object)입니다.

User Exit의 문자 세션이 SET_SESSION_CHARSET를 사용하여 운영 체제의 기본 문자 집합이 아닌 값으로 설정되면(ucharset.h 파일의 ULIB_CS_DEFAULT에 정의됨) 객체 이름이 세션 문자 집합에서 해석됩니다.

실제 길이

반환된 객체 이름의 문자열 길이입니다. 실제 길이에는 널 종료자가 포함되지 않습니다. 객체가 테이블인 경우 실제 길이는 0입니다.

<value_truncated>

값이 잘렸는지 여부를 나타내는 플래그(0 또는 1)입니다. 객체 이름과 널 종료자의 길이가 최대 버퍼 길이를 초과하는 경우 잘립니다.

반환 값

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK