Ets_Output_Value_Cache_Row_Entry_Add()
摘要
添加一个条目,将给定的行索引与特定的对象名称关联。
语法
Ets_Output_Value_Cache_Row_Entry_Add (cache_ptr, obj_name, row_idx)
| 参数 | 类型 | 说明 |
|---|---|---|
cache_ptr |
EtsT_Output_Value_Cache * |
包含目标注册取值的输出缓存。 |
obj_name |
const char * |
层次名称(不含顶层子网)。归调用方所有。 |
row_idx |
long |
该取值下找到此对象的行。 |
返回类型
EtsT_Compcode
成功时返回 EtsC_Compcode_Success(即使该行已存在);否则返回 EtsC_Compcode_Failure。
头文件
ets_api_output.h
详情
如果 obj_name 已有对应的行,除非支持不连续行,否则哈希表中保留原来的 row_idx;在支持不连续行的情况下,新的 row_idx 会被追加到行索引列表中。
如果同一对象有多个相连的行,应只对第一行调用本函数。