op_ima_obj_attr_get_objid()
摘要
获取指定对象中某个复合属性的对象 ID。
语法
op_ima_obj_attr_get_objid (objid, attr_name, value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
关注对象的对象 ID [对象 ID 可以从 Topo 包和 Id 包中的多个内核过程获得: op_id_self()、op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。] |
attr_name |
const char * |
关注复合属性的名称 [这必须是指定对象中已定义的复合属性(objid 类型),否则会发生错误。] |
value_ptr |
Objid * |
指向某个变量的指针,该变量将被填入指定复合属性的对象 ID |
返回类型
Compcode
若成功获取属性值,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
如果处理的是相等的合并复合属性(见注意),value_ptr 将被设置为其中一个合并复合属性的对象 ID(不指定是哪一个),并返回 OPC_COMPCODE_SUCCESS。如果合并的复合属性不相等,则返回 OPC_COMPCODE_FAILURE。
注意: 在合并复合属性的语境中,“相等”意味着复合属性对象上的所有属性都具有相同的名称、类型和值,并且复合属性的所有子对象也相等。
示例
/* Read the Match value string. */
if (IpC_Rte_Map_Type_Route_Map == rte_map_type)
{
op_ima_obj_attr_get_str (match_row_objid, "Match Value", 128, address_mask_str);
}
else
{
/* For firewall filters Match value is a compound attribute. */
op_ima_obj_attr_get_objid (match_row_objid, "Match Value(s)",
&match_value_objid);
/* There should be only one row */
if (op_topo_child_count (match_value_objid, OPC_OBJTYPE_GENERIC) != 1)
{
/* Write a log message. */
ipnl_rte_map_invalid_match_info_log_write (op_topo_parent(match_row_objid),
match_info_ptr->match_property, match_info_ptr->match_condition,
"", rte_map_type);
/* Return NIL to indicate that the parsing failed. */
FRET (OPC_NIL);
}
/* Get the objid of the only row. */
match_value_objid = op_topo_child (match_value_objid, OPC_OBJTYPE_GENERIC, 0);
/* Read the match value string. */
op_ima_obj_attr_get_str (match_value_objid, "Value", 128, address_mask_str);
}
详情
无。
用途
提供一种在仿真过程中动态获取对象属性的机制。该内核过程与 op_ima_obj_attr_get() 的工作方式完全相同,但仅适用于数据类型为 objid 的对象属性。完整用途与详情参见 op_ima_obj_attr_get()。
错误
- 与 op_ima_obj_attr_get() 相同,外加以下内容:
- 程序中止:属性(
<name>)的类型为(<type>)。无法以 objid 类型获取其值。
参考
- 使用内核过程 op_ima_obj_attr_set()、op_ima_obj_attr_set_dbl()、op_ima_obj_attr_set_int32()、op_ima_obj_attr_set_objid()、op_ima_obj_attr_set_str() 和 op_ima_obj_attr_set_toggle() 为对象属性赋值
- 使用内核过程 op_ima_obj_attr_get_dbl() 获取类型为 double 的对象属性的值
- 使用内核过程 op_ima_obj_attr_get_int32() 获取类型为 integer 的对象属性的值
- 使用内核过程 op_ima_obj_attr_get_str() 获取类型为 string 的对象属性的值
- 使用内核过程 op_ima_obj_attr_get_toggle() 获取类型为 toggle 的对象属性的值
- 使用内核过程 op_ima_sim_attr_get()、op_ima_sim_attr_get_dbl()、op_ima_sim_attr_get_int32() 和 op_ima_sim_attr_get_str() 获取仿真属性的值
- 使用内核过程 op_ima_obj_svar_get() 获取进程状态变量的值
- 使用内核过程 op_ima_obj_command() 向对象发出命令
- 使用内核过程 op_id_self() 获取所在处理器或队列的对象 ID
- 使用内核过程 op_id_from_name() 获取任意对象的对象 ID