Ets_Topo_Parent_Attr_Get()

摘要

根据对象句柄和属性名称,获取顶层属性的值。

语法

Ets_Topo_Parent_Attr_Get (child_obj_hndl, attr_name, result_value_ptr)
参数 类型 说明
child_obj_hndl EtsT_Obj_Handle 子对象的句柄。
attr_name const char * 所关注的顶层属性的名称。
result_value_ptr void * 所关注属性的值。(关于此参数的详情参见 Ets_Obj_Attr_Get()(第 958 页)。)

返回类型

EtsT_Compcode

若获取到属性值,返回 EtsC_Compcode_Success;否则返回 EtsC_Compcode_Failure。

头文件

ets_api_topo.h

详情

在使用活动属性时,使用此函数获取顶层属性的值。

通常,你会组合使用 Ets_Topo_Parent_Get() 和 Ets_Obj_Attr_Get(),先获取属性的父对象,再获取属性的值。然而,对于顶层属性,Ets_Topo_Parent_Get() 返回的是原始对象的句柄,而不是该对象的工作副本。因此,对顶层属性值的修改是直接作用于原始对象的,不会立即反映在 GUI 中。此函数通过操作对象的工作副本避免了该问题。

注意: 在不涉及顶层属性和活动属性的场景下,组合使用 Ets_Topo_Parent_Get() 和 Ets_Obj_Attr_Get() 效率更高,应当优先于 Ets_Topo_Parent_Attr_Get() 使用。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com