Ets_Topo_Child_Get_By_Name()

摘要

返回指定父对象中指定类型的指定名称子对象的句柄。

语法

Ets_Topo_Child_Get_By_Name (parent_obj_hndl, child_type, child_name)
参数 类型 说明
parent_obj_hndl EtsT_Obj_Handle 父对象的句柄。
child_type “EtsT_Obj_Type“ 指定子对象类型或元类型的值(取自 表 33 “General Sub-Package Symbolic Constants”(第 1046 页) 中的值之一)。
child_name const char * 指定要返回哪个子对象的名称。

返回类型

EtsT_Obj_Handle

子对象的句柄。

头文件

ets_api_topo.h

详情

当父对象是网络子网对象时,其子对象是直接位于该子网中的节点、子网、链路和注释。当父对象是复合对象时,其子对象是该复合对象的“行”。

child_type 参数可以是具体的对象类型(如 EtsC_Obj_Type_Node_Fix),也可以是通用的对象元类型(如 EtsC_Obj_Mtype_Link)。

路径没有子对象,也不属于任何子网;因此当 parent_obj_hndl 引用路径对象,或 child_type 等于 EtsC_Obj_Type_Path 时,此函数返回空句柄。

child_name 参数必须是非 NIL 字符串,将依次(但不按任何特定顺序)与每个子对象的 name 属性进行比较。name 属性必须与搜索名称完全匹配,包括大小写。如果有多个子对象的名称匹配,则返回其中一个的句柄,但具体是哪一个未作规定。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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