语言环境接口参考

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 通过 执行一个使用以下常量的“或”操作来设置该字段：

• DTW_IN 表示某个参数是一个仅为输入的参数。

• DTW_OUT 表示某个参数是一个仅为输出的参数。

• DTW_INOUT 表示某个参数是一个输入输出参数。

• DTW_STRING 表示参数值是一个指向字符串的指针。

• DTW_TABLE 表示参数值是一个指向表格的指针。

  Net.Data 总是将 parm_descriptor 字段设置为 DTW_IN、DTW_OUT 或 DTW_INOUT，并在它们 与 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() 应用函数来释放原始的字符串。