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>)指向受限对象。
参考
- 使用内核过程 op_id_from_userid() 根据用户 ID 获取网络对象的对象 ID
- 使用内核过程 op_ima_obj_attr_get() 获取对象属性的值
- 使用内核过程 op_ima_obj_attr_set() 为对象属性赋值
- 使用内核过程 op_topo_child() 按类型和索引获取子对象的对象 ID
- 使用内核过程 op_topo_parent() 获取某个对象的父对象的对象 ID
- 使用内核过程 op_ima_obj_hname_get() 根据对象 ID 获取分层名称