op_ima_obj_attr_set_str()

Abstract

Assigns the value of a string attribute in the specified object.

Syntax

op_ima_obj_attr_set_str (objid, attr_name, value)
Argument Type Description
objid Objid object ID of the object-of-interest
[An object ID can be obtained from several KPs in the Topo and Id packages: op_id_self(), op_topo_parent(), op_topo_child(), op_id_from_userid(), and op_id_from_name().]
attr_name const char * name of the attribute-of-interest
[This value must be a defined attribute of the specified object.]
value const char * new value for the specified attribute

Return Type

Compcode

OPC_COMPCODE_SUCCESS if the attribute value was successfully set; OPC_COMPCODE_FAILURE otherwise.

Example

/* 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);
	}

Details

This KP will not report an error if the attribute is not found; you must check the return value to discover this. By not reporting errors, this KP eliminates the need to use op_ima_obj_attr_exists() beforehand to prevent warnings from being generated.

Purpose

Provides a mechanism to dynamically assign object attributes during the course of a simulation. This KP works identically to op_ima_obj_attr_set(), but applies only to object attributes of data type string. Refer to op_ima_obj_attr_set() for full purpose and details.

Errors

Reference

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