op_topo_parent()

摘要

获取指定对象的父对象的对象 ID。

语法

op_topo_parent (child_objid)
参数 类型 说明
child_objid Objid 子对象的对象 ID
[对象 ID 可通过 Id 包中的多个内核过程获得:op_id_self()、op_id_from_userid() 和 op_id_from_name()。此外,对象 ID 也可从 Topo 包内核过程 op_topo_parent()、op_topo_child()、op_topo_assoc() 和 op_topo_connect() 的先前调用中获得。]

返回类型

Objid

父对象的对象 ID。若参数 child_objid 是顶层子网的 ID,则返回符号常量 OPC_OBJID_NULL。

若发生可恢复错误,将返回符号常量 OPC_OBJID_INVALID 所代表的特殊值。

示例

/* Obtain self ID */
myid = op_id_self ();

/* Obtain the attribute values. */
op_ima_obj_attr_get (myid, "address", &my_address);
op_ima_obj_attr_get (myid, "average_interarrival_time", &ia_time);
op_ima_obj_attr_get (myid, "average_service_time", &service_time);
op_ima_obj_attr_get (myid, "ack_service_time", &ack_service_time);

/* Obtain the parent object id and name. */
ppid = op_topo_parent (myid);
op_ima_obj_attr_get (ppid, "name", name);

详情

对该内核过程的连续调用可用于沿对象层次结构向上移动。在一个具有五级对象的示例仿真中,通过五次连续调用该内核过程,即可由子队列对象 ID 逐级获得“顶层”子网(对象 ID = 0),如下所示:

subq_comp_attr_objid   = op_topo_parent (subqueue_objid);
queue_objid            = op_topo_parent (subq_comp_attr_objid);
node_objid             = op_topo_parent (queue_objid);
subnet_objid           = op_topo_parent (node_objid);
top_subnet_objid       = op_topo_parent (subnet_objid);

注意 subq_comp_attr_objid 是一种内置的复合属性类型。对于用户定义的复合属性:

comp_attr_objid   = op_topo_parent (generic_objid);

路径没有父对象,因此如果 child_obj_hndl 引用路径对象,该内核过程将返回无效句柄。

用途

当已知较低层对象的 ID 且需要对较高层对象执行操作时,该内核过程提供了一种沿对象树向上移动的机制。它常用于获取包含当前调用进程所在处理器或队列的节点(进而还有子网)的对象 ID。取得相关节点或子网的对象 ID 后,即可通过内核过程 op_ima_obj_attr_get() 获取在这些层次上赋值的属性的值。

错误

  • 可恢复错误:对象 ID (<child_objid>) 超出范围。
  • 可恢复错误:对象 ID (<child_objid>) 指向受限对象。

参考

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