Ets_Topo_Child_Get()
摘要
返回指定父对象中指定类型的索引子对象的句柄。
语法
Ets_Topo_Child_Get (parent_obj_hndl, child_type, child_index)
| 参数 | 类型 | 说明 |
|---|---|---|
parent_obj_hndl |
EtsT_Obj_Handle |
父对象的句柄。 |
child_type |
“EtsT_Obj_Type“ |
指定子对象类型或元类型的值(取自 表 33 “General Sub-Package Symbolic Constants”(第 1046 页) 中的值之一)。 |
index |
int |
指定要返回哪个子对象的索引。 |
返回类型
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_index 参数必须是介于零(含)与 Ets_Topo_Child_Count_Get() 以相同的父对象和相同的对象类型调用时返回的计数值(不含)之间的值。