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 类型获取其值。

参考

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