GET_COLUMN_INDEX_FROM_NAME

有效對象

擷取與 Replicat

說明

使用 GET_COLUMN_INDEX_FROM_NAME 函數來決定與指定資料欄名稱關聯的資料欄索引。如果使用者結束程式的字元階段作業使用 SET_SESSION_CHARSET 設定為作業系統預設字元集以外的值 (如 ucharset.h 檔案中的 ULIB_CS_DEFAULT 所定義)，則使用者結束程式與程序之間交換的字元資料會以階段作業字元集解譯。

如果資料庫區分大小寫，則必須以與主控資料庫中定義的相同字母大小寫來指定物件名稱；否則，大小寫並不重要。

語法

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

資料欄名稱的指標

<actual_length>

緩衝區內資料欄名稱的長度。

<source_or_target>

下列其中一項，指示是否要使用來源或目標表格來查詢資料欄資訊。

EXIT_FN_SOURCE_VAL
EXIT_FN_TARGET_VAL

輸出

<index>

指定資料欄名稱的傳回資料欄索引。

傳回值

EXIT_FN_RET_INVALID_COLUMN
EXIT_FN_RET_INVALID_CONTEXT
EXIT_FN_RET_INVALID_PARAM
EXIT_FN_RET_OK