Allocates an entry in the Logical Table. The logidx parameter is the requested logical index. If logidx= 0, the function tries to use the first available index in the table. If logidx= 1 or greater, the function tries to use the specified index. If the specified index is in use, the function returns the first available index in the table. As a result, the returned index might not be the same as the requested logical index.
The allocLogicalEntry() function returns the logical index that is allocated to the entry. The memory that is associated with xnewLogicalEntry can be freed. The function creates a internal copy of the data.
The entLogicalEntry_t structure definition is shown in entLogicalEntry_t Structure. Special cases for xnewLogicalEntry values are handled as shown in the following table.
Object |
Value of xnewLogicalEntry |
Entity MIB module handling |
---|---|---|
entLogicalDescr |
NULL |
reject |
entLogicalType |
NULL |
{ 1,3,6,1,2,1 } |
entLogicalCommunity |
NULL |
"" |
entLogicalTAddress |
NULL or "" |
reject |
entLogicalTDomain |
NULL |
reject |
entLogicalContextEngineId |
NULL |
"" |
entLogicalContextName |
NULL |
"" |
Returns the index allocated to the logical entry.
Returns -1 for error in adding the entry. Check the log for more details.