Net.Data 使用 dtw_parm_data_t 結構將參數傳給語言環境。 參數的來源有三種:
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 結構中的欄位:
Net.Data 永遠會將 parm_descriptor 欄位設定為 DTW_IN、DTW_OUT 或 DTW_INOUT, 並將邏輯 OR 用在 DTW_STRING 或 DTW_TABLE。請勿修改該值。
parm_value 欄位指向由 Net.Data 執行資料堆所配置的物件, 此資料堆是 Net.Data 用來配置動態記憶體的記憶體區域。如果 parm_value 被置換為其它字串, 則必須釋放原始字串,並將其置換為指向由 Net.Data 資料堆所配置之字串的指標。使用 dtw_malloc() 與 dtw_free() 公用程式函數來配置並釋放字串, 且使用 use dtw_table_New() 與 dtw_table_Delete() 來配置並釋放表格物件。 也可以在沒有可用及重新配置空間的情況下,修改表格物件及字串。
parm_value 指標及其內容不應被輸入參數修改。 同時,亦請勿刪除或取代參數列示中的表格物件。