Ets_Obj_Attr_Promoted_Status_Set()
Abstract
Sets an attributes status to promoted or not.
Syntax
Ets_Obj_Attr_Promoted_Status_Set (obj_hndl, attr_name, is_promoted)
| Argument | Type | Description |
|---|---|---|
obj_hndl_ptr |
EtsT_Obj_Handle |
Handle of object of interest. |
attr_name |
const char * |
Name of attribute of interest. |
is_promoted |
EtsT_Boolean |
Determines if the attribute is to be promoted (EtsC_True) or not (EtsC_False). |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if the attribute exists, is symbolic, and is valid. EtsC_Compcode_Failure otherwise.
Header
ets_api_obj.h
Details
One advanced feature of the architecture is that it supports “promotion” of attributes associated with lower-level entities to higher-level entities. An example of this is that attributes defined at the process model level are automatically promoted to be attributes of the parent processor or queue (i.e., the module that is executing the process model). This allows the attributes to be assigned values on a module-by-module basis. If attributes are not assigned values at the module level, then the attributes will be automatically promoted to the node level; one more recursion of this type promotes the attributes to the network-wide level.