Ets_Output_Table_Value_Register_With_Type()
摘要
创建已注册值处理器对象,并将其注册到全局缓存中,供 Ets_Output_Obj_Value_Get() 使用。
语法
Ets_Output_Table_Value_Register_With_Type (value_name, result_source, obj_type, table_name, column_name, hot_link_column_name, value_type, value_func_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
value_name |
char * |
输出值的名称,Ets_Output_Obj_Value_Get() 的调用者将以该名称访问此输出值。 |
result_source |
EtsT_Output_Source |
该操作有效的模式。必须是表 171 Output Package Symbolic Constants 中列出的符号常量之一。 |
obj_type |
“EtsT_Obj_Type“ |
该操作适用的对象类型。有效对象类型的符号常量列于表 33 “General Sub-Package Symbolic Constants“(第 1046 页)。 |
table_name |
char * |
获取数据所在的 OT 表名称。 |
column_name |
char * |
用于获取数据的列标签名称。 |
hot_link_column_name |
char * |
用于获取拥有该数据值的对应 hot link 对象的列标签名称。 |
value_type |
EtsT_Output_Value_Type |
所获取的单元格值是单元格中的原始值,还是 hot link(若存在)的值。必须是表 171 Output Package Symbolic Constants 中列出的符号常量之一。 |
value_func_ptr |
EtsT_Output_Reg_Function |
为获取值而调度的函数。该函数的原型见 EtsT_Output_Reg_Function。 |
返回类型
EtsT_Output_Reg_Value *
指向已注册值的只读指针;失败时为 PRGC_NIL。
头文件
ets_api_output.h
详情
该函数创建 EtsT_Output_Reg_Value 对象,将其放入缓存,并把该对象返回给调用者。该对象归缓存所有,调用者应只读方式使用该对象。
注意: 该函数的形式适用于存储在输出表中的已注册值。访问其他数据存储中的输出值可能需要使用其他形式。