Ets_Topo_Parent_Attr_Set()
Abstract
Sets the value of a top-level attribute, given an object handle and attribute name.
Syntax
Ets_Topo_Parent_Attr_Set (child_obj_hndl, attr_name, …)
| Argument | Type | Description |
|---|---|---|
child_obj_hndl |
EtsT_Obj_Handle |
Child of the object containing the attribute to set. |
attr_name |
const char * |
Name of the attribute to set. |
… |
(variable) | Value to set on specified attribute. |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if the attribute is set; EtsC_Compcode_Failure otherwise.
Header
ets_api_topo.h
Details
Use this function to set the value of a top-level attribute when you are using active attributes. For other situations, the combination of Ets_Topo_Parent_Get() and Ets_Obj_Attr_Set() is more efficient and should be used instead of Ets_Topo_Parent_Attr_Set(). See the Details section of Ets_Topo_Parent_Attr_Get() for more information about why to use this function.