Ets_Topo_Parent_Get()
摘要
返回指定子对象的父对象的句柄。
语法
Ets_Topo_Parent_Get (child_obj_hndl)
| 参数 | 类型 | 说明 |
|---|---|---|
child_obj_hndl |
EtsT_Obj_Handle |
子对象的句柄。 |
返回类型
EtsT_Obj_Handle
父对象的句柄(如果存在)。
头文件
ets_api_topo.h
详情
如果指定对象没有父对象,或无法确定父对象,此函数将返回无效对象句柄。可使用 Ets_Obj_Invalid()(第 1026 页) 检测该返回值。
当传入的是顶层属性时,此函数返回的是父对象相关结构的指针,而不是对象本身的指针。
注意: 如果将此函数与 Ets_Obj_Attr_Get() 组合用于顶层属性,并且将使用活动属性,则应改用 Ets_Topo_Parent_Attr_Get(),而不是 Ets_Topo_Parent_Get() / Ets_Obj_Attr_Get() 的组合。
对于节点、子网、链路和注释等网络对象,其父对象是该对象被安装到的子网。除顶层子网外,所有这些对象都有父对象。
路径没有父对象;因此如果 child_obj_hndl 引用的是路径对象,此函数返回空句柄。
一般而言,复合对象的子对象不记录其父对象,因此此函数不会成功。但是,如果该子对象是作为被编辑的对象传递给 Edit Attributes 对话框的回调,则此函数将返回网络层次结构中上一级正在被编辑的对象,并可继续向上追溯。