Ets_Output_Value_Cache_Row_Entry_Add()
Abstract
Adds an entry that associates a given row index with a specific object name.
Syntax
Ets_Output_Value_Cache_Row_Entry_Add (cache_ptr, obj_name, row_idx)
| Argument | Type | Description |
|---|---|---|
cache_ptr |
EtsT_Output_Value_Cache * |
Output cache containing the registered value of interest. |
obj_name |
const char * |
Hierarchical name (without top subnet). Owned by caller. |
row_idx |
long |
Row in which the object is found for this value. |
Return Type
EtsT_Compcode
EtsC_Compcode_Success if successful (even if the row is already present); EtsC_Compcode_Failure otherwise.
Header
ets_api_output.h
Details
If there is already a row for obj_name, the original row_idx is kept in the hash table unless discontiguous rows are supported. In that case, the new row_idx is added to the list of row indices.
If there are multiple connected rows for the same object, this function should be called for the first row only.