語言環境介面參考手冊

dtw_parm_data_t 結構

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 結構中的欄位:

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

parm_name
parm_name 欄位是指向含有參數名稱之字串的指標。 如果參數是文字字串,則 Net.Data 會將該指標設定為 NULL。不應釋放或修改該指標, 且不應修改名稱內容。

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

parm_value 欄位指向由 Net.Data 執行資料堆所配置的物件, 此資料堆是 Net.Data 用來配置動態記憶體的記憶體區域。如果 parm_value 被置換為其它字串, 則必須釋放原始字串,並將其置換為指向由 Net.Data 資料堆所配置之字串的指標。使用 dtw_malloc() 與 dtw_free() 公用程式函數來配置並釋放字串, 且使用 use dtw_table_New() 與 dtw_table_Delete() 來配置並釋放表格物件。 也可以在沒有可用及重新配置空間的情況下,修改表格物件及字串。

parm_value 指標及其內容不應被輸入參數修改。 同時,亦請勿刪除或取代參數列示中的表格物件。

res1 與 res2 是保留欄位。


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]