語言環境介面參考手冊

dtw_parm_data_t 結構

Net.Data 使用 dtw_parm_data_t 結構將參數傳給語言環境。 參數的來源有三種：

• 指定在 FUNCTION 區塊定義上的明確參數

• FUNCTION 區塊定義上，指定在 RETURNS 關鍵字上的傳回變數

• Net.Data 起始設定檔中，指定在 ENVIRONMENT 架構陳述式上的參數

Net.Data 會先傳遞明確的參數，然後傳遞 ENVIRONMENT 陳述式中所指定的參數， 最後是傳回變數。

dtw_parm_data_t 結構有下列格式：

typedef struct dtw_parm_data_t {        /* 參數資料                   */
    int   parm_descriptor;            /* 參數描述子                  */
    char *parm_name;                  /* 參數名稱                    */
    char *parm_value;                 /* 參數值                      */
    void *res1;                       /* 保留                        */
    void *res2;                       /* 保留                        */
} dtw_parm_data_t;

dtw_parm_data_t 結構中的欄位：

parm_descriptor

parm_descriptor 欄位說明要傳遞到語言環境之參數的類型及使用。 Net.Data 使用下列常數執行 OR 運算，來設定這個欄位。

• DTW_IN 表示參數是只能輸入的參數。

• DTW_OUT 表示參數是只能輸出的參數。

• DTW_INOUT 表示參數是輸入及輸出參數。

• DTW_STRING 表示參數值是指向字串的指標。

• DTW_TABLE 表示參數值是指向表格的指標。

  Net.Data 永遠會將 parm_descriptor 欄位設定為 DTW_IN、DTW_OUT 或 DTW_INOUT， 並將邏輯 OR 用在 DTW_STRING 及 DTW_TABLE。

parm_name

parm_name 欄位是指向含有參數名稱之字串的指標。 如果參數是文字字串，則 Net.Data 會設定這個指標 NULL。

parm_value

parm_value 欄位是指向含有參數值之物件的指標。 如果參數值是尚未定義的變數，則 Net.Data 會將這個指標設定為 NULL。

res1 與 res2 是保留欄位。

parm_name 及 parm_value 兩者都指向由 Net.Data 執行堆集 所配置的物件， 此堆集是 Net.Data 用來配置動態記憶體的記憶體區域。 如果 parm_name 或 parm_value 被置換為其它字串， 則必須釋放原始字串，並將其置換為指向由 Net.Data 堆集所配置之字串的指標。 使用 dtw_malloc() 及 dtw_free() 公用程式函數來釋放原始字串。