op_id_from_name()

摘要

获取按父对象、类型和名称指定的对象的对象 ID。

语法

op_id_from_name (parent_objid, obj_type, obj_name)
参数 类型 说明
parent_objid Objid 父对象的对象 ID
[对象 ID 可以从本包中的其他几个内核过程获得:op_id_self()、op_id_from_userid() 和 op_id_from_name()。对象 ID 也可以通过 op_intrpt_source()、op_topo_assoc() 以及 Topo 包中的许多其他内核过程获得]
obj_type int 目标对象的类型
[该值是标识目标对象类型的整数代码(参见表 69 “Object Type Symbolic Constants“ 第 19 页与表 66 “Object Meta-Type Symbolic Constants“ 第 18 页。)]
obj_name const char* 目标对象的名称
[该值必须与一个现存对象的名称匹配,且该对象的父对象和类型须由另外两个参数指定,否则将发生错误。]

返回类型

Objid

与指定父对象、类型和名称相匹配的对象的对象 ID;若没有现存对象符合指定条件,或发生可恢复错误,则返回 OPC_OBJID_INVALID。

示例

/* determine the object ID of the desired remote queue */
rem_node_objid = op_id_from_name (0, OPC_OBJTYPE_NODE_FIX, "frnt_end");
rem_queue_objid = op_id_from_name (rem_node_objid, OPC_OBJTYPE_QUEUE, "buffer_a");
/* obtain key state variables of queueing process */
prio_thresh_ptr = (int *) op_ima_obj_svar_get (rem_queue_objid, "prio_thresh");
protocol_version = (char *) op_ima_obj_svar_get (rem_queue_objid, "proto_ver");
/* modify the state variables */
*prio_thresh_ptr = 44;
sprintf (protocol_version, "Ver 5.1")

详情

该内核过程的三个参数用于把全部仿真对象的集合逐步缩小到唯一的目标对象。对象的名称及其父对象通常足以标识单个对象,因为 Riverbed Modeler 编辑器会阻止同一上下文中的不同对象使用相同名称。但通过 EMA 构建的模型不会检查这一情况。

用途

提供一种将对象名称映射为对象 ID 的机制。与仅限于作用于网络域对象的 op_id_from_userid() 不同,该内核过程也可以作用于节点域对象。该过程通常用于获取远程或本地节点内某个模块的对象 ID,以便访问该模块属性的值。

错误

  • 程序中止:Segmentation violation。(由于格式错误的 obj_name 参数)
  • 可恢复错误:对象 ID(<parent_objid>)超出范围。
  • 可恢复错误:对象(<parent_objid>)没有子对象。
  • 可恢复错误:对象(<parent_objid>)没有指定类型且名为(<obj_name>)的子对象。
  • 可恢复错误:对象 ID(<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