op_ima_obj_attr_set_str()

摘要

为指定对象中的字符串属性赋值。

语法

op_ima_obj_attr_set_str (objid, attr_name, value)
参数 类型 说明
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 * 目标属性的名称
[该值必须是指定对象的已定义属性。]
value const char * 指定属性的新值

返回类型

Compcode

若属性值设置成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

示例

/* Extract the interface’s address and subnetwork mask. */
op_ima_obj_attr_get_str (addr_info_attr_objid, "Address", IPC_ADDR_STR_LEN,
	address_string);
op_ima_obj_attr_get_str (addr_info_attr_objid, "Subnet Mask", IPC_ADDR_STR_LEN,
	subnet_mask_string);
/* Check the values of addresses. If the value is left empty, assign AUTO_ADDRESS */
/* to it. A valid address is at least 7 characters, such as 0.0.0.0. */
if (strlen (address_string) < 7)
	{
	op_ima_obj_attr_set_str (addr_info_attr_objid, "Address", IPC_AUTO_ADDRESS);
	strcpy (address_string, IPC_AUTO_ADDRESS);
	}
if (strlen (subnet_mask_string) < 7)
	{
	op_ima_obj_attr_set_str (addr_info_attr_objid, "Subnet Mask", IPC_AUTO_ADDRESS);
	strcpy (subnet_mask_string, IPC_AUTO_ADDRESS);
	}

详情

如果找不到该属性,此内核过程不会报告错误;你必须检查返回值才能发现这一点。由于不报告错误,此内核过程免除了事先使用 op_ima_obj_attr_exists() 以防止产生警告的需要。

用途

提供一种在仿真进行过程中动态赋值对象属性的机制。此内核过程的工作方式与 op_ima_obj_attr_set() 完全相同,但仅适用于数据类型为 string 的对象属性。完整的用途与详情参见 op_ima_obj_attr_set()。

错误

参考

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